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Appendix A 
Routine Summaries 



This appendix contains Unix-like summaries for the routines that are built into the Amiga 
ROM (or kickstart) software, as well as summaries of routines in disk-loadable libraries. The 
debug library documentation is included here as well. 

These documentation files are organized on a functional basis. For example, things pertinent 
to Exec are listed under "exec.library/someDocFile". Things pertinent to graphics are listed 
under "graphics.library/someDocFile". 

The tutorial sections of this manual give you information that shows how these routines 
relate to each other and the prerequisites for calling them. 

Most routines are listed as part of a library of routines. Before you can use a routine within 
your program, you must assure that the library is opened. This is explained fully in the 
"Libraries" chapter of this manual but it bears repeating here. You open a library by using 
the OpenLibraryQ function. The call takes the form: 

struct LibBase *LibBase; 

LibBase = OpenLibrary(" library .name", version); 

where: 



library. name 

is a string that describes the name of the library you wish to open. 

version 

is the version number of the library that you wish to have opened. A value of says 
give me any version. A value of 31, for example (latest as of this writing) says open 
specifically version 31 of this library or greater if 31 is not available. 

If the library is disk-resident, it gets loaded and initialized. The OpenLibrary() returns the 
address of the library base, which you must assign to a specific variable. It is through this 
means that your program links into the library-specific interface code that is contained in 
amiga.lib. 



The following is a list of the names of the libraries that are currently part of the Amiga 
software and the corresponding names of the library base pointers associated with them: 

Library Name Library Base Pointer Name 

exec.library ExecBase 

clist. library ClistBase 

graphics.library GfxBase 

layers.library LayersBase 

intuition. library IntuitionBase 

mathffp. library MathBase 

mathtrans.library MathTransBase 

mathieeedoubbas.library MathleeeDoubBasBase 

dos.library DosBase 

translator.library TranslatorBase 

icon, library IconBase 

diskfont.library DiskfontBase 

ramlib.library — (not useful to C language) 

Example: 

#include "graphics/gfx.h" 

struct GfxBase *GfxBase; 

GfxBase = OpenLibrary("graphics.library",0); 

if(GfxBase == NULL) exit(NO_GRAPHICS_LIBRARY_FOUND); 

Note: If your program is coming up through the normal startup code (see the Work- 

bench chapter of this manual) the exec.library and dos.library are already opened 
for you. Thus you needn't open them yourself. 

The reason for this code are 



1. C, when calling a routine, takes the parameters for the routine and pushes them 
onto the stack. For example: 

x = Routine(parmA, parmB); 

Then it calls a routine named "_Routine" (adds an underscore to the head of the 
routine name). 

2. The underlying ROM (or disk based) code usually expects its parameters to be 
passed in registers rather than on the stack. This is to make it truely general pur- 
pose (does not impose a particular stack frame), and more efficient for assembly 
language coding. 

Therefore, the interface code at ..Routine, in turn, saves the contents of registers 
the routine will use and pulls parameters off of the stack and jams them into 



registers, finally passing control directly to the actual starting location of the routine 
itself. 

The linker needs the library base location since it is through a jump-with-offset from 
a machine register that the _Routine entry point is found. (The Amiga uses a relo- 
cating loader in AmigaDOS, so you can never be sure exactly where a library of rou- 
tines is located. However once the system has loaded a library, it knows how and 
where to find it and gives you a way to use the library's routines.) 

The following shows typical interface code linked to your program from amiga.lib: 

xref JLibBase ;Library base name is defined in 
;user's file, this code gets linked 
;to user's program, get the value 
;from there when library is opened. 



xdef _Routine 



.Routine: 



;make _Routine name external, 
jvisible to linker. 



move.l A6,-(sp) ;save register(s) 

move.l 8(sp),A0/Al ;copy parms A and B to regs. 

move.l _LibBase,A6 ;load library base address 

jsr _LVORoutine(A6) ;go to real routine 

move.l (sp)+,A6 ;restore registers 



rts 



where JLVORoutine is a value representing the offset, within the library, at which the 
"real" routine (the one that expects parameters in registers) is located. 

When you are finished using a library, at the end of your program, you should close it, using 
the CloseLibrary function as follows: 

CloseLibrary(LibBase); 

If the system is running out of memory and needs to free up space, it can check the library- 
accessors field for various libraries and for those whose accessors value is zero, it can retrieve 
the memory that the library had used. 
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abs 

AddAnimOb 

AddBob 

AddDevice 

AddFont 

AddFreeLlst 

AddGadget 

AddHead 

Addlnt Server 

AddLlbrary 

AddPort 

AddResource 

AddTall 

AddTask 

AddVSprite 

Allocate 

AllocCLlst 

AllocEntry 

AllocMem 

AllocRaster 

Al 1 ocRemember 

AllocSignal 

AllocTrap 

AllocWBObject 

AndRectRegion 

Animate 

AreaDraw 

AreaEnd 

AreaMove 

arnd 

AskFont 

AskSoftStyle 

AutoRequest 

AvailFonts 

AvailMem 

BeginRe fresh 

BeginUpdate 

BehindLayer 

BltBitMap 

BltClear 

BltPattem 

BltTemplate 

Bui ldSysRequest 

BumpRevision 

Cause 

CEND 

ChangeSpr i te 

ChecklO 

CINIT 

ClearDMRequest 

ClearEOL 

ClearMenuStrip 

ClearPointer 

ClearRegion 

ClearScreen 

Close 



mathffp library 
graphics library [gels] 
graphics library [gels] 
exec library 
graphics library [text] 
icon library 
intuition library 
exec library 
exec library 
exec library 
exec library 
exec library 
exec library 
exec library 
graphics library [gels] 
exec library 
clist library 
exec library 
exec library 
graphics library 
intuition library 
exec library 
exec library 
icon library 
graphics library 
graphics library [gels] 
graphics library 
graphics library 
graphics library 
mathlink_lib library 
graphics library [text] 
graphics library [text] 
intuition library 
diskfont library 
exec library 
intuition library 
layers library 
layers library 
graphics library [text] 
graphics library- 
graphics library 
graphics library [text] 
intuition library 
icon library- 
exec library 
graphics library 
graphics library 
exec library 
graphics library 
intuition library 
graphics library [text] 
intuition library 
intuition library 
graphics library 
graphics library [text] 
dos library 
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Close 

CloseDevice 

CloseFont 

CloseLibrary 

CloseScreen 

CloseWindow 

CI oseWorkBench 

CMOVE 

ColdReset 

ConcatCList 

CopyCList 

CopySBitMap 

CreateBehindLayer 

CreateDir 

CreatePort 

CreateProc 

CreateStdIO 

CreateTask 

Cr eateUp f r ontLayer 

CurrentDir 

CurrentTime 

CWAIT 

DateStamp 

dbf 

Deallocate 

Delay 

DeleteFile 

DeleteLayer 

DeletePort 

DeleteStdIO 

DeleteTask 

DeviceProc 

DisownBl itter 

DisplayAlert 

DisplayBeep 

DisposeLayer In f o 

DlsposeReglon 

DoCollision 

DoIO 

Doubleclick 

Draw 

DrawBorder 

DrawGList 

Drawlmage 

DupLock 

EndRe fresh 

EndRequest 

EndUpdate 

Enqueue 

Examine 

execute 

Exit 

ExNext 

faddi 

FattenLayerlnfo 

fcmpi 



translator library 

exec library 

graphics library [text] 

exec library 

intuition library 

intuition library 

intuition library 

graphics library 

exec library 

clist library 

clist library 

graphics library 

layers library 

dos library 

exec_support library 

dos library 

exec_support library 

exec_support library 

layers library 

dos library 

intuition library 

graphics library 

dos library 

mathlink_lib library 

exec library 

dos library 

dos library 

layers library 

exec_support library 

exec_support library 

exec_support library 

dos library 

graphics library 

intuition library 

intuition library 

layers library 

graphics library 

graphics library [gels] 

exec library 

intuition library 

graphics library 

intuition library 

graphics library [gels] 

intuition library 

dos library 

intuition library 

intuition library 

layers library 

exec library 

dos library 

dos library 

dos library 

dos library 

mathffp library 

layers library 

mathffp library 



Dec 6 16:05 1985 library_list Page 3 



fdlvi 

ffltl 

FindName 

FindPort 

FlndTask 

FindToolType 

Flood 

FlushCList 

fmuli 

fnegi 

fpa 

fpbcd 

FreeCList 

Fr eeCo 1 orMap 

FreeCopList 

FreeCprList 

FreeDlskOb j ect 

FreeEntry 

FreeFreeList 

FreeGBuffers 

FreeMem 

FreeRaster 

FreeRemember 

FreeSlgnal 

FreeSprite 

FreeSysRequest 

FreeTrap 

FreeVPortCopLists 

FreeWBObject 

fsubi 

ftsti 

GetCC 

GetCLBuf 

GetCLChar 

GetCLWord 

GetColorMap 

GetDefPrefs 

GetDiskOb j ect 

GetGBuffers 

Get I con 

GetMsg 

GetPrefs 

GetRGM 

GetSprlte 

GetWBObject 

IEEEDPAbs 

IEEEDPAdd 

IEEEDPCmp 

IEEEDPDiv 

IEEEDPFlt 

IEEEDPMul 

IEEEDPNeg 

IEEEDPSub 

IEEEDPTst 

IncrCLMark 

Info 



mathffp library 

mathffp library 

exec library 

exec library 

exec library 

icon library 

graphics library 

clist library 

mathffp library 

mathffp library 

mathlink_lib library 

mathlink_lib library 

clist library 

graphics library 

graphics library 

graphics library 

icon library 

exec library 

icon library 

graphics library [gels] 

exec library 

graphics library 

intuition library 

exec library 

graphics library 

intuition library 

exec library 

graphics library 

icon library 

mathffp library 

mathffp library 

exec library 

clist library 

clist library 

clist library 

graphics library 

intuition library 

icon library 

graphics library [gels] 

icon library 

exec library 

intuition library 

graphics library 

graphics library 

icon library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

mathieeedoubbas library 

clist library 

dos library 
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InitArea 

InitBltMap 

InltCLPool 

InitGels 

InitGMasks 

InitLayers 

InltMasks 

InitRastPort 

InitRequester 

InltStruct 

InitTmpRas 

InitVlew 

InitVPort 

Input 

Insert 

IntuiTextLength 

IoErr 

I slnteractive 

ItemAddress 

LoadRGB4 

LoadSeg 

LoadView 

Lock 

LockLayer 

LockLayer I n f o 

LockLayerRom 

LockLayers 

MakeLlbrary 

MakeScreen 

MakeVPort 

MarkCList 

MatchToo 1 Va lue 

ModifylDCMP 

ModlfyProp 

Move 

MoveLayer 

MoveLayer I nFr onto f 

MoveScreen 

MoveSprite 

MoveWindow 

MrgCop 

NewLayer I n f o 

NewLlst 

NewRegion 

OffGadget 

OffMenu 

OnGadget 

OnMenu 

Open 

Open 

OpenDevlce 

CpenDlskFont 

OpenFont 

OpenLibrary 

OpenResource 

OpenScreen 



graphics library 

graphics library 

clist library 

graphics library [gels] 

graphics library [gels] 

layers library 

graphics library [gels] 

graphics library 

intuition library 

exec library 

graphics library 

graphics library 

graphics library 

dos library 

exec library 

intuition library 

dos library 

dos library 

intuition library 

graphics library 

dos library 

graphics library 

dos library 

layers library 

layers library 

graphics library 

layers library 

exec library 

intuition library 

graphics library 

clist library 

icon library 

intuition library 

intuition library 

graphics library 

layers library 

layers library 

intuition library 

graphics library 

intuition library 

graphics library 

layers library 

exec_support library 

graphics library 

intuition library 

intuition library 

intuition library 

Intuition library 

dos library 

translator library 

exec library 

diskfont library 

graphics library [text] 

exec library 

exec library 

intuition library 
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OpenWindow intuition library 

OpenWorkBench intuition library 

OrRectRegion graphics library 

Output dos library 

OwnBlitter graphics library 

ParentDir dos library 

PeekCLMark clist library 

PolyDraw graphics library 

PrintlText intuition library 

PutCLBuf clist library 

PutCLChar clist library 

PutCLWord clist library 

PutDiskObject icon library 

Putlcon icon library 

PutMsg exec library 

PutWBObject icon library 

QBlit graphics library 

QBSBlit graphics library 

Read dos library 

ReadPixel graphics library 

RectFlll graphics library 

RefreshGadgets intuition library 

RemakeDlsplay intuition library 

RemDevice exec library 
RemFont graphics library [text] 

RemHead exec library 
RemlBob graphics library [gels] 

RemlntServer exec library 

RemLibrary exec library 

Remove exec library 

RemoveGadget intuition library 

RemPort exec library 

RemResource exec library 

RemTall exec library 

RemTask exec library 
RemVSprite graphics library [gels] 

Rename dos library 

ReplyMsg exec library 

ReportMouse intuition library 

Request intuition library 

RethinkDisplay intuition library 

ScreenToBack intuition library 

ScreenToFront intuition library 

ScrollLayer layers library 

ScrollRaster graphics library 

ScrollVPort graphics library 

Seek dos library 

SendIO exec library 

SetAPen graphics library 

SetBPen graphics library 
SetCollision graphics library [gels] 

Set Comment dos library 

SetDMReguest intuition library 

SetDrMd graphics library 

SetExcept exec library 
SetFont graphics library [text] 
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SetFunction exec library 

SetlntVector exec library 

SetMenuStrlp intuition library 

SetPointer intuition library 

SetProtection dos library 

SetRast graphics library 

SetRGB4 graphics library 

SetSignal exec library 
SetSoftStyle graphics library [text] 

SetSR exec library 

SetTaskPri exec library 

SetWindov/Titles intuition library 

ShowTitle intuition library 

Signal exec library 

SizeCList clist library 

SizeLayer layers library 

SizeWindow intuition library 
SortGList graphics library [gels] 

SPAbs mathffp library 

SPAcos mathtrans library 

SPAdd mathffp library 

SPAsin mathtrans library 

SPAtan mathtrans library 

SPCm P mathffp library 

SPCos mathtrans library 

SPCosh mathtrans library 

SPDiv mathffp library 

SPExp mathtrans library 

SPFieee mathtrans library 

SPFlt mathffp library 

SplitCList clist library 

SPLog mathtrans library 

SPLoglO mathtrans library 

SPMul mathffp library 

SPNeg mathffp library 

SPPow mathtrans library 

SPSin mathtrans library 

SPSincos mathtrans library 

SPSinh mathtrans library 

SPSqrt mathtrans library 

SPSub mathffp library 

SPTanh mathtrans library 

SPTieee mathtrans library 

SPTst mathffp library 

SubCList clist library 

SumLibrary exec library 

Superstate exec library 

SwapBitsRastPortClipRect layers library 

SyncSBitMap graphics library 

tan mathtrans library 
Text graphics library [text] 
TextLength graphics library [text] 

ThinLayerlnfo layers library 

Translate translator library 

UnGetCLChar clist library 

UnGetCLWord clist library 
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UnLoadSeg 

UhLock 

UhlockLayer 

UnlockLayerlnfo 

UnlockLayerRom 

UnlockLayers 

UhPutCLChar 

UnPutCLWord 

Up f r ontLayer 

UserState 

VBeamPos 

ViewAddress 

ViewPortAddress 

Walt 

WaitBlit 

WaitBOVP 

WaltForChar 

WaitIO 

WaltPort 

WaltTOF 

WBenchToBack 

WBenchToFront 

WhichLayer 

WindowL imi ts 

WindowToBack 

WlndowToFront 

Write 

WritePixel 

XorRectReglon 



dos 

dos 

layers 

layers 

graphics 

layers 

clist 

clist 

layers 

exec 

graphics 

intuition 

intuition 

exec 

graphics 

graphics 

dos 

exec 

exec 

graphics 

intuition 

intuition 

layers 

intuition 

intuition 

intuition 

dos 

graphics 

graphics 



library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
library 
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ABS 

abs 

BNDRYOFF 

CEND 

CINIT 

clearerr 

CMOVE 

CWAIT 

feof 

ferror 

fflush 

fileno 

FOREVER 

getc 

getchar 

InitAnlmate 

isalnum 

lsalpha 

Isascil 

lscntrl 

iscsym 

Iscsymf 

isdigit 

isgraph 

islower 

isprint 

ispunct 

isspace 

isupper 

isxdigit 

ITEMNUM 

MAX 

max 

MENUNUM 

MIN 

min 

NOT 

ObjAlloc 

putc 

putchar 

RASSIZE 

RemBob 

rewind 

SetAfPt 

SetDrPt 

SetOPen 

SetWrMsk 

SHIFTITEM 

SHIFTMENU 

SHIFTSUB 

SIGN 

STREQ 

SUBNUM 

TMAlloc 

toascii 

TOBB 



.h 
.h 
.h 
• h 



.h 
.h 
.h 

.h 



clib macro [macros .h 

lattice macro [stdio. ti 

graphics macro [gfxmacros .h 

graphics macro [gfxmacros .h 

graphics macro [gfxmacros .ti 

lattice macro [stdio.b 

graphics macro [gfxmacros 

graphics macro [gfxmacros 

lattice macro [stdio 

lattice macro [stdio 

lattice macro [stdio.b 

lattice macro [stdio.b 

intuition macro [intuition 

lattice macro [stdio 

lattice macro [stdio 

graphics macro [gels 

lattice macro [ctype .h 

lattice macro [ctype .h 

lattice macro [ctype. h 

lattice macro [ctype. h 

lattice macro [ctype. h 

lattice macro [ctype. h 

lattice macro [ctype. b 

lattice macro [ctype. h 

lattice macro [ctype .h 

lattice macro [ctype. b 

lattice macro [ctype. h 

lattice macro [ctype. h 

lattice macro [ctype .b 

lattice macro [ctype. h 

intuition macro [intuition. h 

clib macro [macros .h 

lattice macro [stdio .h 

intuition macro [intuition. b 

clib macro [macros. h 

lattice macro [stdio.b 

intuition macro [intuition. h 

workbench macro [workbench. h 

lattice macro [stdio.b 

lattice macro [stdio .h 

graphics macro [gfx.h 

graphics macro [gels. h 

lattice macro [stdio.b 

graphics macro [gfxmacros. h 

graphics macro [gfxmacros. h 

graphics macro [gfxmacros .h 

graphics macro [gfxmacros .b 

intuition macro [intuit ion. h 

intuition macro [intuition. h 

intuition macro [intuition .h 

intuition macro [intuition. h 

workbench macro [workbench. h 

intuition macro [intuition 

workbench macro [workbench. h 

lattice macro [ctype 

graphics macro [gfx 
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tolower 
toupper 



lattice macro [ctype.h] 
lattice macro [ctype.h] 




i 



<S S2||g|ljg 

JS (UMWMMWMMU] 

X WWMMMWWWW w 

MMMI3MMMMM ffiOQ fl) 

* * ^A^Aifr^iiliHS lies! s sis sissESSSs! 

a a gggggggggggggggggggggggggggggggggggg 

- A-l - 




! 






U\ o\ o* 



<< 




t% 



•J<J 



m 



-A-2- 



9 9 (y> 9 9 9 

A n it it it it 

A Jl || it V » 



o* b* o> 



II II II 



§ 



9 99999 
n n n n (S (fl 



ees'saa 



8 

< 



J 1 I 



u 
u 





- A-3- 




& 



i 

b 



s 



01 

© 



II 



<< 




W 



SI 


3 


8.8. 


a 


II 


I 


4 4 


«j 


88 


3 



JJ 



. >j < *> h 



28 B § 



Si 

83 



- A-4- 



I 



<< 




8 



3 

in 

a 




■P 
U 
4J 



u 
w 
en 




-A-5- 






1 



d§ 

r-t 

u « 

si 



a 



*li 


S 


s.| 


f-l 


w 3 


c 


c c 





•H 




4J fl 


w 


« -H 


■H 


<t 


8 


<M 


z 




a. 



w 
u 
w 



I 

a 
S 

o 



r-l p* 

! ! 



w 

M 
U 



in 



u 
w 
u 



u 

UJ 




I 



M 

! 



! 



8.J 



n 

eg 
•5! 

§2 



II 



* 



I & 



■I. 

i:§ 
ill 



g_ 

■H ■? 4J 



h.i 



SQH 5 pi 

is 



e e 

8.8. 
II 



51 

(9 M 



P.O. 



as 



S3 B 



I 

g 

£ 



I ♦ 

8 " " " 

s s&s. 

o f» «s f« 

** y y a 



g , 

1 SB! 




- A-7- 





-A-8- 





- A-9- 



ft* 



1 



9s 

•as 



o o 



I 



5 -w a 
£ o 



o 

4J 



II II II 



o o o 

QDO 



3! 









11 



Si 



© 

a 



o o o 
o o o 

V A II 

OOO 






3 



§ 

z 



u 
u 
u 




- A-10 - 





- A-ll - 





- A-12 - 





- A-13 - 





- A-14 - 





- A-15 - 





- A-16 - 





- A-17 - 






53 

■H JJ 

p 

!! 

fa 



■H 3 

4-> 4J 

« 8 

O I. 



o 
a 

I 

s 







- A-18 - 





- A-19 - 




IUUUIUUUUU 

i u u w (a w u w 
I w w u w w u w 






3: 



1 iffiififi!«!iiiiiiiiiiiii3iiiiiiiiiiiiliiiiiii^i 



■ ■aiiiiMMiillllllllillllillilllillllilliiiUllSm 

- A-21 - 






& 



31 



I 

I 

I 

i 

I 



o 



I 

ft 

a- 

1 



a 
u 



8 



? 

n 4J J c 

,QHH O 

5V 

55|fc 

« T3 

55 

I 



,2: 



V* 

!£8 



4J ±J 

55 
8.8. 

55 
11 



11 
I 



o 
■p 



iii 



5 
3 8 



•• .. ii 

111 



1! 



I I I I I 



33 



881 



u 

w 
to 



5 



i 
j 

I 



0* 



I 

5 



IS 

ii 

! 



eg- 

3 a - 

c; ° fe 

a Rrt 

§111 



83*1 

tin 

OH <« 
i 8 

"5 



IS 

8.8. 

11 



S 

8. 

S 

1 



S £ 



w 
w 

t/1 



- A-22 - 



I 



1 



$ 


<M 


H 




* 




<N 


a 


0< 


r-l 


O 




* 


* 




<M 


l 


1 



'5* 

i § 



m 



ESS 

3 « « 

$* 
2U§ 






S 



CO 



S 

8. 
I 



M 




- A-23 - 




I 

* 

1 



g 


1 
> 


rt 


? 


s 


1 


0> 


■H 


e 




* 


a- 




<M 


1 


1 



h 



33 


a 


8.8. 


8. 


n 


S 


4J 4J 


4J 


A a 




g 



11 . 1 



as 



- A-24 - 



w 
w 
to 



I 



o 



<M 

! 



I 

I 

& 

t 



i 



I 



h 



g 



6*. 



I 

s 

-H 



2£ 



£-5 5 

ill? 



I! 



0* r-4 

a in II 

> H « 

9 3* 



I 



5 






iiii 



sisss 



i -H 

a S3 




- A-25 - 





- A-26 - 




I 



1- 

u 



§ 



s 



111111 

<u <u <u <S <S <S 

A X H Jl V >4 

11111! 

(H<HlH<UtH<H 
I I I I I I 



111 

<u <S <S 

A V II 

in 

<U <U <M 



- A-27 - 



V) 





- A-28 - 





- A-29 - 




r 

i 

i-t 

a 
1 



I 

3* 






is 



81 



•HOW 



I 



a 



2 

o 



4J 



- A-30 - 



3 



„ II II g A 

II — A V O 

C A 



ffltiB 



V II 

II 
aa 

ftft 



4J 



i 



u 
w 

03 






I Kt -O 



r 



a ii N ii 

a u +> w 



3 3 3 
I 



5 . 
8 * 

<-* r-i r-* 



o c c c 
<h 5 5 5 



8 



I 

•o 

c 



ill 



111 

<u u w 

V A II 

111 

£ <a & 



u 

S3 



u 
u 
to 




- A-31 - 




t 



I 



a 



I 



o 



11 1 



§ § § 



- A-32 - 




I 





Ja 


ss 




!: 


■W 4J 

38 


*■■* 







K 


5§ 


SS 


.c cj 


•P -H 


•H -H 


<MQ 


r-t 

a* 


55 


u c 2 


Q.O. 


<wQ 


Z; ^ 





^" 


Q i-l 


>H p-t 




S§ 


33 




u 

u 


•83 



5 

4J 



a 
o 



m Da 
w u 
cj u 



I 




* 



u 
w 
to 



- A-33 - 




1 



«3 




« 


rl p-l 




IM <M 


<H 


ss 


s 


•H ~i 


•H 


ajs 


J 


u 


1 


o e 


e 



I < 



u 
w 
w 



u 
u 

w 



- A-34 - 



! 



I 

2, 

i 

1 

i 






3 



! 

3 



3 
U 



I 5 



31 

8.1 

8 8. 



5S 

•a o 

4J 



COM 
.0 4J -H 



SI 



I 



IS 



?3 



;i i 



4J «J> 

•y 



3 

■y 



1*3 



b >S 

hi fijj 



Mil 

u a *> ja 



ii ii 



*J5 

J3 J3 



B 



5 



3 fi 



I 



u 
u 

CO 



a 

ft 

a 



il 



Ma 



a 



U 

I 

1 

i 



i 



i 



o 

"3 






a 

3 

1 






5|ff 



I 
b 



I 



- A-35 - 



a 
a 



i 



a 

•-I 

a 



5 



i3 



a^ 
la 



IV o 
9 A «>" 



1? 



•o .aa 

LOlH 

9 ¥. B..P 



•u o 

a**5 
8.a„* 






«cg 



G a § 






IK 

III 

88<2 




tJ M o TJ o S 

$-h x-~x _ 



CO 
0] 
M 

in 



o « 4J u o o c 

iiHfel 

•P -u e 3 

tu 5 co as w o o 
II II II II II 

X CO W CO CO 



0. 

JS 



■o 



I 



Hi a co S § c 5 4J fe r 

o , . o <8 .y i. o « £ go a 



Is 

i-t o 






? 



I 



w 

8 




- A-36 - 



5 







2 




R 




fa 


5 
1 


1 


1 


5 


I 


1 



5 






52 1 S 



I 
8. 

I 

o 



& 






8 8 g 

5 3 i 

u 
w 
u 




- A-37 - 




8 



1 



oi 



I 

2 

! 



I 



8. 

s 



is 



f 

n 

5.0 

1$ 



I 



I? 

B.gS 
o u 



t 



J J 



N 1 



I 



I 

i 



- A-38 - 





- A-39 - 





- A-40- 





- A-41 - 





- A-42 - 





- A-43 - 



t 



I 






2 




s 


1 




1 


1 

! 


1 


1 

bu 



t 



s\ 



6 

Ul 



o 

£ 



I 
S 



I 



52 f S 



3 " 
(0 

a 



s 



ID 
U 

w 




- A-44 - 



f 



! 



I 

a 



8 


f 


5 
1 




1 


<N 




t 


© 


8 


I 


* 


l ■ 


% 


l 


ll 








8. 






I 
i 



B 

to 



- A-45 - 



- A-46 - 




I 



in 
S 

O 

5 



si 



3§!dli 




» ^^^^^^^^^^^ 

3 HHHHrtHrtHrtHHrtHHrtHHHHHrtH 

H ooouooooooououuouououo 

- A-47 - 





-A-48- 



1 

i 



t 

1 


iH 



« 




V 

ft 


in 

8 


TreaCLlst 
•lot - froo 


5 

is 
5 



3 I to 

b Cm 



o a 
*■ 

'I 

15 



3i 

q 



2 
s 

r 

1-4 

8 
5 






i 1 



S 
« 



* I 



.■d 



I 




-A-49- 




1 

j 



e 



I 

■H 
l 



s 



I 



1 - 

I 



4 



si: 



ill! 



Hi 
l i 

II 

jljg 

lisll 



u 

1 ! 



'3 £ 



I i i 
31 ft 2 

fiij 






Jt 

I 



I 



1 



,11 



BS 



14 



- A-50 - 





- A-51 - 



5 



I 



u 

m 

5 
8 



I I 1 



I 



i 

•ss 

i 

is 



§1 



* « fe s 



SSSS 
si's fra 



JS 



J- I 



»8 



J 8 

O • I 

ah 



1*1 

O " 

I 



«<H I « U 






t 

r-t 

u 

1 



8. j 



k 



4J 
01 

rH 

o 



1 J 



g 

M 

L 



§si 



1 

Bi 



s 

1* 



1 



\ 

i 



! 

I 



I 



i i i 



i, 



i I? 



•a S 



I? 

ii 

8| - 
Ill 

«; 

i 

IH 

I 






A- 



2 r/> P _ ** J "< 

^ Bfis lili 



i 



5 | 

8 ti 



i a 



8 s 



2k 



°5 



W O 



§1 

19 im 

•H 

19 

I 



.Jl.jl , 
I I it 



•H « • 

III 



- A-52 - 





- A-53 - 



I 

U 



O 

in 







18 

si 
B»to 

f° 

ll 

Is 



o 

1 



3§ * 
3$ 8 



i 



o 

k 

N 



! 

°8 



! 1 



838 

ill 



I e. 



S! 




- A-54 - 



1 






I 

pi 

i 



i 



i 



is 



I I 8- 3. 



ii 

a 

1 « 
1 *> 



55 
I** 




■HHL8B 

HOjO 
O O « 4J 

-sis* 






i 
j 

u 






5 ° 



3 
,13 




- A-55 - 




0> 




1 




0* 




1 




1 

*-4 




1 


8 


l 


w 


£ 


e 


f 




1 


<n 


P* 


J 


1 




58 
Jf 

I 



•3 



s 






z$ 



I* 

Sri 



0> 



V o 



5 £s 



38 3|£ 

r-C ""3 






JS 



1-8 






I 






ft I 

S< 

ft t 



It 

c o 



8 IjS 



I 



3 . 



4.* 

W -IJ 
■rt H 

I* 

c c 



SI 
1 



3 



1 

■s ih a <m 
I'd" fljj 



- A-56 - 





- A-57 - 



i 















S 









I 

3 



I 



1 ? 



•o 



V 

a 



ife 



55 



IJ 



O o 

Is 



3SS pa-d 



col 



T! 
B8 



- A-58 - 



i 

fit 

I 

i 

* 



o 
I 



t 



i 



I 

■H 

i 



I 

■o 



5 T 






i 

In 



I 



3 8 

<M 6 



i§ 



* 



I 

r-l 
l 



Sm" 



III 

" B i 

sis 

<J35 

3 lU •-» 
k. >H -I 

* OB 

"Sfrfe 

o£g 

til 



3 
. JO 



.4J 1 u 



*^ J 



o *; e c 

"'is* 



la 

S3 

•6 c tj n 8 (2 
S J5 2 « 4 >m 8 

a i-i <u m Biff 

«H SOU C 

in « | £ 9 t w 

H L g II 3 

•H 5 JJ 4J ■o jC 

|S55-§ S 

JJ 



J|5s| 



'I' 

U I -I 
- _ - 1 I H 

W 5 C AJ « 
H 3 • « 9 > 

5 0-4 

•H » Stj «- o 

* JJ ID iJ C <u 

C 4J -J « 
■0 C >. ±1 -O 
Sbu0jQL.cS 

i-4 rH *M * 9 -^ 

W -I >,& 4J 

< <w 5 jo o 



•HO JJ 

u 

II C4J 

3 1 

tine 

4J J 



2 

■ C r5 +J 

2£ • g 

SS 0-H 

N -H U 
> I « 3 -I 

i -H V. i. u 
j A <m o JJ 2 

J <M -( <u U -H 



SI 




- A-59 - 




0* 



•H 



o 
r- 

H 

m 



a 






1 
o 



J. 

O 61 

W U 8.1 § 

*j * 8 4J S 

S-58fc§ c 

O rt TJ (8 o £ 
5 [14 rH & 



1 




B M 4J a 



I. 






! 



i 



4J 



l 



- A-60 - 



I 



* 






« £ a « jj w 

&2 t 4J « _ k. 
JrtiJl* op 

W W H CiJ { U-PUB 
4-> 4J 4J 0* B Q. H -I -H 

JDOOOOOOOOO 
XXXXXXXXXX 

UMUIUMHUMUH 






I 

IS 
8 



0> 

o 







i a o 



IM*- 



&9- 

16. 



J .link 



A 
■ —. 1- 

■y a 



s5 






Hill §p!§ s | | f l^liilfiflillililllllil 

1 1 ill 8 8 U X I y i y tit nil ItltMlf till f If f f f film 



- A-61 - 




Ot o 



& 



8 



J_ 1 



5 



1 



8 
I* 



Is 

§•2 



i' 

"la 

Sol 

4J 

§2" 






is. 

« 

s 

I 



- A-62 - 





- A-63 - 




J 



a 






0> 



* v 



S 



| | gg 



I'm o o-oS 



111 hi 






:l«ii 












u 



lllaff :8 

_ b*i3h jo a 

iahiliijl 



i 



S 



a 

■ 



i 



- A-64 - 



s. 



I 



m 



4J 
« 

i 



1 



la 

<g 



h. 



1 

J" 8 

■° s 

O tj 
10 









5 



y 



I « « 8 

3 3 5 & 



« -H 

« O 4J -P 

o "■« I 



§ I 



53 
1 






i sS ss S3 lis' 



a 

■u B n 

■ Oil 
■H f-l j! 

IP 



■p 

5 

a 

i 

< 



*< -h js 



g'S ■ S S F 
£ 8. o § s § 

8iT828£ 

4J -IB 
H 9 O Q, M 

£352. uS 

V -t -H b) 9 3 
4J 



9 +J ffl * 

« J5 O » 9 

8,g ' nSS 
1 s£ 

III 



M 
U 
W 




- A-65 - 



t 



f 



1 



8 



f 

2 



,§,«< 



ii 



Pis 



f 



'L 



I S 



9 U 

m 



» 



g •!& 



«• >•£ 



•P 7J.S *J 

u o • 5 

'Nil 



5 
1 










Sgfr fr p fr fr 

8. e £ e w * 
g"<w 9 5 S S § 

*», 



*. *■ g 

u 6 8 u 

M M 

rf °< H rf 

g a s g 

o, 0, Sj ^ 



H 3 

3 1 



QOOXiJiJtJiJbliJiJiJiJtJ 






a 

c 



Pi 1 



w > 
ii 



I 
flu 



8 



I 

3 



Jl 






J 3 



i 






> 5 

<M < 







5 



u 

w 
w 



- A-66 - 






0< 





iif** 8 !!* 

hah;* 



•H IQ 
•J HI 1- 4J 
O <H O >H O 

n 5 e jj « 

illl 



"jo 'IS 

a *j a « 

3 .<« H 

n q,o o 



a 
5 



I 




- A-67 - 



ft 
£ 



i 



ta & 



I I 



I 3 



a 
ii 

1 



r* 01 8> 

IH M -H O 

2 W oo 



IS 

:1J 



§ i 



i^ 



."** 



i *i 

8.Q >, 



§ I 



I 






JS 



§ s i a 

33 *^ a v 

xi -a $ a 

■H L $"0 & C 

ja -P S r-l u 

« m « 10 

• W Oh a S 

C -H 8 « -( rH (J 

h3 op 5. <->S R. 



I 



1 



iS 









5s 



1- 

83 



So 

10 & 



r i 



ts-a 



w 
w 

03 



s 



1 



5 

3 



il 



I 



-8 



5>v 



St- 
ill 



la 6 H 

81? sral 



& 




u 
u 

CO 



- A-68 - 





- A-69 - 



3 



i 

I 



i. 
o 



o* 




4J 



O 

4J 



ll 
1 



8 «* $i& 



si 



§0 

"1 ** 



6£ 



i. 

§ 
o 

I 

a 



99 

as 

M 






f 
& 







- A-70 - 







O 



1 « 




- A-71 - 



CM 

i 

0, 



0> 



I 

(-1 

4 



5 



Is 

i-H 



> 5 
9 



2 8 



o I 5 

*' 3 52 
"JUS 

III: 




JS" 3 






■^ I i s i- 83 



* 



1 



s s S -, - 



" S B 1 1 1 o 



2*3 



I J 8 1 !1J1 i«a»il 

Mil M^JJa 

if hliirt 

10 M 3 fi II < .O 



I 1 |J Plj 
jl 1 . 



I 

5 



4J 3 V 

an? 



o 



!■!! 

a- a 

'1' 
Ifi 

S If. 

i« BE 



S 

15 



i 



2 



13 



u 

Si 






8 



I i 






5*- 



I 3 S3 BlllUi ii 



.11 



55 



- A-72 - 





- A-73 - 





- A-74 - 





- A-75 - 



I 



in 

o 



r-t 

! 

a 
a 



i i 



% 



•h e 






Si 



III ! 



-1" 

hi 

a 



I I 



8"« 

S3S 



1 

slii 



h 



& 



So), 




- A-76 - 




s 

1 



3 

0> 



I 

1 



! 



* I 



i 



n 



•?i 



HI 



hi 



i. 



4* II 



8 



1 ill! S 



* 



1 * 



- A-77 - 



cu 



in 

9! 



i 

I 



5 



•H 

3 



o 

no 



eg 

•8S3 
Ml 



I 



lis 



o 

if 

Is 






a 
J 

Is 

-SI. 

IMS 

o v *j <o 

E<2 i I 

iS s 8 

8 >• 

JJ -h £ 

s 5 * 



i 






•p - - 

il aj 

N M In 
■ii ^4 -H 
IS 

•o 8 B 



8 it 



! ~ i ! 






5, 
en 9 



•u 
in 

.U 



C -H 



o o < 

•H -H <M <H ±J 




Jj5JJ*m?*js 

*i +J -H ** ** © <?*0 © O c 



r is j 



I H » .O f 



iortOHioHOHiwu 

BoortHBooHtHBcg 

« 8 S 8 



e 

O 4J 

ii 

o 

© >, 



I 



3 



1 



I 



I 3 



rt 



I I 



r 



9 
8 N 

• -HO 

21! 8 M 



§1 

IS 

o 
8 S" 

-J- 

o c 

i 5 

-t - r-t 
j5 -H 4J 

■ * -s 

flfr- 

9 * 

osc J? 

(-4 



■H 
-4 " 

o 

4J in 



83 

3 Eh 



i:si 
s|| a 

•5 S N 

ffi S © r-t 

J3 _ N It 

S 3 II) 4J 

5 §^ 



Si 



s 






I 



Is 



5t 

IT 8.1 

hi* 

§4§ 



M o" 



I* 



5a 

JJ in 



>s& 



i 

n 



v n v 8 ■ bo*) 8 

thJt *li * 



SSsS s „ 

Pfl « 5 5 



o 
t-i 

■H 

5 • 
a o 

<8 






5s 

S.0 



I 



I 



ii 






- A-78 - 






s 

! 
J 



o 



I 

u 



I 

* f 



4J 

•a _ .? 



•S o 

| 1 

O C _ 4J O 

if! II 

hi - a i 



8lf£ 111 




- A-79 - 







* 



r 



3 
■a 



5a 

i 



I 



1 t 
(if, 

Si*."* 

fii" 

sagg* 



Mil* 



i*i 



ul 



£ •■rife. 

pl : liildi 







o 

•H 

.J 

£.U 



I 



J 



Si 

4J « 






4J 

I 



u 
u 

03 



- A-80 - 




r 



& 



m 
m 

o> 

o 






I 



o 

4J 



5 



2* 



1 §£2 



2$ 

ml 
-1:1 

a 1 

S a 4J o 

I.VIIV 



gill 




i >. c -h 
t 3 r -h 



■! 






3 1 



,1 i 



I 



& 



If! 1 MM 



eS 



o 



u 



- A-81 - 




n 
« 



I 



o 



I 




£ ■* S « 8>a 9 J J jj 

Bb*P, 
fi q a. S J5 






B * 

W 4J 






8.8 8 His 

c T3 « 

uilJjri: 

■a S5^-S J«^- 




flam* 



Hit 



o 

1 



0> 



JJ 



J3 o> 

f5 4J-0 
.. - 9. 



rfr a 



3f 3* 

* 3 « tt jj U 

5 5,-h <• o d a 
h „ o i« * S3 

r* V) ffl *-■ (BHbu 

o&o-hSow 




8.1 



o 



o k. 

4J u 



-? 

a: 



al 



I 



- A-82 - 





- A-83 - 





- A-84 - 





- A-85 - 






1* 



0> 



g 

II 

h 

I 






Is! 



9<u^ 
-I' 

IP 
t-ji 

si 

aj!j 

Li! 

■5 o 8 o 



_ a E a J* 

tM J 



1 
ti 

13 



I 












3 






J_l 



2 I 



1 



o 

J 

f 



I 1 lis BJ J J 



- A-86 - 





- A-87 - 






I I 



•H 

5 







■"< 






0>l3rH 

o ^ 



•HI _| 



( 



3 to % zS 

C MHO OS 



£ 



38 S5-S2 



rt *| 



J 



f 



3 * I 



5 



5 

a 

i 

! 



J ^ 

"S fa 

f a 

1 i 



a 



in 

s 



.Li 



I 



a 



I 



a. 

no 



s 



II 



8* 



■4 0<HH 

.•di 






1 . § 3 ■ 

Is? 



pSs gill 



5 
1 



1 S A * 

: * ft l 

I s - If. 

« j j M 

I « a 2 fc 

lis I «4& 

ali j SMI* 

J - - * * 



I 1 1 8.1 






ft 



- A-88 - 



••1 



3 

I 

■ 



O 

1 



•H 

4 






^i 

I 



u a 
ia 



ii 
a 



I I 



i 

a 
a 

1 



i 



I 1 

g g 



I'd sc • 

(■HO O . 
I OQ Hi 



ft • 



3 



$ 9 



> o 



S-&; 



I 



I 1 2 



: * 



5 SS 



1,1 U i~. 



aom 



- 1 1 I i 



■H *-l -H 3> 



* go as d I? 



! 






1 



J_ I 





i ii ii | 
|| || If t 



* * 



ii ii 



S3 $$ 



Q) 4J O 

JJJft 



«5 8. 

•H 3 n 



il 






•B *5 rt 8 

SjlJj 



41 f 






S5£ 
si 5 !*! 

*i- M - s 

a i l-S 

* ■ 8*3. 



Itfto 



1 



1 



h..: 



Ill * 



t*< o 



- A-89 - 





- A-90 - 



t 



10 



0> 



J 



r 



i 

5 



if 



L 



r! 



sill 5 
ill? f 

OrtlH 



S« 3 






si ■ 
SI'S 



* a 



.Ik 






! 



3 



% 



i_l 



1 » 



I " 



5 

I 
38 






2.2 

Pf 






ill 



ail»l 

irtju. r - 



c8?a 



J5J* 



laa-g^a 



51 



2 8" 



135 
55 



! 1 



s& 






•a I si liil'&H | 5 S i& oS 



- A-91 - 




i 

i 



i 



I 



is 6 A e 

■it 8 

IS 2*1 

9 T* ft P 



P 9" 



k* 81* 

sias 



|oS glAiS? 



It, 

3? ! 



5 8 S « <u 



tail 



I'll 

US** 

Iff 



8- B? 



J 



- A-92 - 



a 



s 

I 



s 

o 



s 



22 
S 

i 



J 



I 



ai;*!* 



p 5 *i 1^. 



R< 



a«M C «H i-l -H 



I! 






a n V (0 -H -H 4-> 

gfl 1-1 _ ■ h 

12 ..J SP- 



SS 



§ i sts ills iil^ni 



« 






I 

HI 

§ 

5 

I 

8. 



J3 

t 

§ 
8 

iH 

o 

ft 

p 



§ 

i ■ 



S! 



o 

M 

■o 



w 

8 




- A-93 - 




- A-94 - 



! 



b. 



nil Llril 










s fFffffffffffffffffffFB , l'E"E , fB , Fl i ""fl"rff 



I 

8 



(* 



in 

o 



I 



•iHifiili""} f awi 

i o ff sJ 9 ague S o -h .3 <» 8 o>n u T l T) i 

i9l3£5jJ?aS9tt*&lfBlil! 

33 , a]>s£S2a3333385«""".S 



| 
-«$? 



* 33333333333333333335 3 3 33333833588 8 8 3 8 88 8 8 8888838888 8 

a tiiiii!iiiiii!ii!i!i!ii!itniittiiiiiw»i*H***wi* 



- A-95 - 




& 

I 
8 



8 



s 



\ 



3 
1 



ii 



*i 2 












Q D Q, -h 

8 8-3 M "g 



'I 



J! i 



3 J 



0* 



s. 



8. 



ii ii 



iff] 



- A-96 - 




I 



ft 

I 



h 



o 
m 
J 



1 



t 



8 

I 



J 



5 



? 



s 

6 



1 



is* 

la .2 

V ■** rH 

lis 

pi 



i 

5 



I If* Iflf B l 

1 



*S 



- A-97 - 





- A-98 - 




8 



b> 



o 



I 

fH 

i 



! 

fH 

! 



I 

■-4 

s 



J 

5 



r 







Siii I, 



to 



- A-99 - 



.* 3 



I 



8 

H 

o 



f 

I 

8 



h 






1* 
I 



SO 
MS 



II 

I 



?I 



8. 



I 



& 





Is. 

5 i 



i? 

8.1 



_ V b -5 J 

i i a* 



s 



u • 



*ji ° 



if 



si 

St 



i 



■g 

5 J 
JS jg 



H 



S 



M 
W 
W 




- A-100 - 





- A-101 - 




A 
ft. 



h 



8 



9 

1 

f 



I 

i 

8 

i 

I* 



5 

s 



? 



03 
4J 



^ 



w ai 



■3 s a 



^ las p I.S S 




55 



i: 



ii ^ 



4"S 
s w 

■ft ,n 

£3 

O CO 

g -5 6 9 i' '• 

A 4J u n r- o 

•■ w -h ^ 

, « • w 

fa . • -< 



4J O 

8 § 

A 

3 B 



§5 . 



I At ^<M 



■&.H c 



4J a c SB 






*.88 

_ 18 M 

A 



A Q,<u 
fa fa e -? x o .1^ 

09 ^ o 3 ? 82 

III**'" 

| a § o 



■M ffi A W 



!*SS 5 



>1M 



iH c -j 

111? 5 ! 



fife 

S _ 3 



c . ff-g o 5 
3 >i-" * *j a 

Q <H L 

r* ffl (A < 



C 

V. o 



><OII|H 



fa _ N _ IS 

{SEmSS 

! 

01 









! e u i S> 
' a — 

!c o e o 
lunin 

I 4J O O © 
J Ottttft 

I k. • I I 



A 



i 



3 

o 

A 



" 1 

H 8 

a - a 



- A-102 



I 



St 

*: 

if 

ii 

li 

II 



>.-o 



8 



m 

o 



1 

I 



S) 

IS 



1 



5 



5 



8? 
15 



HICH 






i! 



•J |m 

•H --H 



oo oi 
*>*> fa 5.1 



0* 



m 

8 

in 

e 



1 



k 



I 



1 



1 

* 



b. 






• rf 



ll 



8°M 



feS-9 8 



ti 



(8 " n " ta 
•m S 8 Q 8 

III 



S 



s | 8. 5 a2 



i * 




hi £ J f Ik 

SI >«»* 8. • « = - - 

:I8 mi" 8 5 *8 li II 

1i* iii nl !iJ 5 

V 

JS 



■H « 






« 



3 -"a .2 •" !i * . rt »■ c .. •■ ■ 

■ !■« 



8.l!si3 -s 




I 





i 



- A-103 - 



I 

(-1 

8 








ft 

I 



i 



o 

H 

in 






fe 



I 



I 

a 



HUH 



U 

to 




- A-104 - 



s 

I 



•H 







ft 




« 




04 




j 




s 




i 


H 


t» 


s 




•1 


8 


? 


o 


1 




i-H 


r» 




i-i 
m 


8 




H 




4' 



o 
o 



5 1 
n ii 



3d B, * ■ 

O* «H « 



i 





M 




i 


l 

8 


f 



Ifl 

e 



I 



"3 



5 



h 




3 S ^ 5 im 



&* 



T 1 $ P. s 



Jar* 






!nte« 



*J 



41. « mS • 




- A-105 - 



I 



O 

si 



I 






i 

§ 



1 1 



?<• 



I 



U CO u 



s 


i" 


> 


3 


S 


■g 


pH 


e 


8 


« 


? 


s 


u 


•H 


1 


l 




O 


±i 


*J 




L 


8 


$ 


? 


5 


4J 


a 


8 


H 


L 




•H 




fH 




a 




* 


R 


I 


! 


* 




i-H 




§ u 





i i 

hi M 



ft. 



f 



in 

o 

H 



II 

1 



& I 



S 
§ 



8 



1 



! 



as 



s .1 II 



5* 8° 

jfjJI 

-H ■OH 
a J! 4J 4J -H 



s -° « 5 U 



«g" 







N 

S 

| 

I 

o 

|5 



o 



sga b-'JJJI SZ 
"Ill* ^ 



u o 



- A-106 - 





- A-107 - 



& 

It 
a. 

I 



in 
o 

l> 

H 

m 



f 

■H 

! 



ta 



I 



3«3 . 

fe 3 

m 

o « ta m 
o w 



CO 

"3 

& ... . 



3 "« 



i s 1.^1 

> l. -( X 

_ W •a rH i) 



•P .a 3 -8 A 

B ^ W "9 

<H iH ..- - 

* 

3 S -P 



H 
U 



'I' 



!*3 

§ o 



b 

r-t 

8 

03 ffl 



$* 



« * 

b-S 

4J 

8.1" 



^ I 



I 



u 

u 

CO 






0. 



3 

! 



o 

H 
l»> 



t 



4 

1 

o 

•p 

> 
S 



g 

■H 

I 



in « 

:3b* 



'I 

S i-H 

ffl * 

II II II 

o « > 



o a 



■SJS 

r 



P o 

b-3-S 

1 

is- 51 



lis 



I 



A- 




s 

o 



ft 

3 w 



I 

9 

! 



> 

u 



> 

I 



J J3 



§ 5 



II 



I 

I 1 ! 

^§3 



I! 



og 



o > a 



9* 

3 

I 






its » 



iS 



B 



- A-109 - 





- A-110 - 



I 



I 

b. 



o 

si 



! 


! 


1 


s 


»-» 


s 


5 


h 


| 


1 



1 

1 



I 



I 



h. 



u 









1 

■p 






J? 



1 



•H<M 9 0S 

-i a o 

•0 Oil 

til-*-**! 

B-huhhO J 
o u 



* 

4 



i 



55 

tefe 

H 

8.8. 
ii ii 



4J 



i 



1l 



si 



w 
to 



I 



1 



i 

ft. 





a 




f 


in 

o 


1 



5 



I 



I 



o 

■p 

! 

4J 



*g 



Q 



OT& 



ffl 

i 



I 



i ! 

i 

8 



8.8. 



frl? 



- A-lll - 




» 



8 



o 



ca 



i 



I 



5 i Is 
I H If 
I 1 I 



i 



2 ;* If 



_ „ J 

£ si u 



1 * jfe 3 i it" 



I , I r 1 1! la rl 



& II Is 2 ..si ** j|33i 



os-3 fl^ 



I 



* T ** 3 5 * 8 I! "•* 

I i ! lff if * 

3 M c .las a II &il 



- A-112 - 





- A-113 - 




I 

<M 

2 

i 

c 






8 



! 



in 

o 
m 



3 « 



8 gi g8<S«835 



5 I 



g 
J" 



8.8.1 

I " " " H 

nit 5 



- A-114 - 




i 



in 

o 



i 



31 






o 

Ji 



l-t 

i-H 

! 

9 

a 



i 

e 
II 

* 

■H 

a 



5 5- 

•H 4J M 






I 



id 

•a 



i 4* V <G W 

1 i 5 a 



*'-S 






m°i: 

85" 






Mil 2 

1 tu 



Jihif A 



- A-115 - 






£ 



Si 

w 

o 

n 



rH 

s 

!9 







55 



JU 



1 

II 



S u o a 8 « S 

8 atil' 1 ! a 

se tnnu-< 



i. 
o 

I [u 



5 * 

s • 

i-t «4 

•9 8 



ii ! i 



O 



l si 






3 



«| 

OOM 
*J 4J 3 

9 

SI1 
a 8.1 
ii H it 

I rt M o 

lasts 



o 



a 



si 



o 

I z 



w 
u 
to 




- A-116 - 



! 



8 

I 



3 

I 

a 



5 



I 



5 



Is 
fe. 



.f: 



Pi 

Pi 

• u -a 

5 . o o 

o e *j +j 

•*3 45 



1 8 

I ! 

ss 

I 



a *S 



k. 



ii ii 
3 









ss 



"w -* a • 



1 81 1 L«J 

3 h *i . o o 3 



J ■« 

« U 



O O -H 



r 



i « ITS- 

I 3?l 

2 8 4.1 

^ >-i m _ j! 

I 1-1 M S J3 rl 

° « * 5 -.? 

-l -h M Em 9 m 



8 



3 



3 
3 



3 



3 



3 

■H 






9 



10 

e 



3 

5 



h 



v 



i 

I 




I 



a 



- A-117 - 



04 

I 

8 



H 

m 

o 

m 



I 

si 



3 

s 



i 

10 



3 

I 

iH 

a 



c 



§3 

3. 

i 

i' 



•a h 
■2* 



m 

4-> 



8 



•H £L r-t 

5 * J* "8 • g 
c .5322 



e c oii 

> S 1 a I § 

ill**!! 



If 
g*f 

ff!i 

© a (j b 
all 

3 jj— s« 

a J B 

|i| 




x 

d 
w 



fa. 



w 

03 




- A-118 - 





- A-119 - 



3 

i 



1 
i 



4J 

B 



i 



a 

! 



i 

S 5 



*"i° ij 



Cut'' 

■3 O 







$*£■ 



is 



3 i-3 c 8 

CL O O 

b c 






5°5U 



«« 8 



•Si is I ■ 

n « o « 

§S§55 



«a I 

> 9 3S 



ha 

h 5 *J 

o a-H 

3 J« 



(3 



,8* 



AS'i'gjs InJ 



IIJI 



1 

I 8 

| t 

» I * 
t 3 J 

10 JO 

J HI iuii -a 

6 -y j> J J .8 

•-i « no 

39A ifi 



i 




- A-120 - 



A 



s 

•-< 

m 

o 

r> 

H 

en 



3 

I 



i> 



3 

5 

i 

E 



8. 



51 I 



3d 
44 1 



£Ji 33 



S 



CO *J 

t-l -H 

to C 



fib. 

§•81 



8 §I 5 

fiog 






* 



SI- h. 



• 4J 5 <-< 



II 



8. a 5 



lit, 



lit 



«-« xi S 5 



% 5 






1 



J* 

i 

ta 9 & 



! o 



lllj 

8,« a u 






I 



5 

! 

<M 

5 






- A-122 - 




! 

I 

m 

o 

m 



1 



V 




ll" 88 8 



i 



S-8 



O 

•-* 

- .8 

-is 

w 

VJ 

5 « - 

8_ 

ill 

lit 

58 

•a u -1 

SO -H 

ir 
!*- 

M 
si- 

B *) H 



J 

> 



- A-123 - 



b. 



o 
10 



I 



4 



h 



* 



•o 

1 



1 



>3 

i 

> 

r 



> 

(9 
.1 



IK 

> -! 



~ I 



B 3 

§1 



c 

M Q 



8" 



5 



iff 

hi 
IS 1 



is aa£ 



ar 
'I 



5 

> > 



I I 



« 8 5 



■9 I 



I 

1 

4J 



B 
•H 



l 



5 



III 



|4 



i 8 «| 

SQ.H 5 4J 

«>-! * 3 " 



*5S 






1 



r-i 



1 



.1 



8* 

^-s O 



j.3 

kS 






I 

I 

5 



m 

e 

H 



I] 



6 B 

si 

3^ 



in 



3 
p 



4J 



S*SC§ 

o 

4J-0 U4J 

|S ||| 

1 8 S H3S? 
1 111 MM* 



3 V 

n 



i« 3 fie3sfiSSS B s 



- A-124 - 




I 

[ 






a 



I 



\ 



© 
m 
J 



I 



i 

! 



g ! 



** 






J? >p 

$3 



o v 

u 



- A-125 - 




m 
I 



! 



m 

o 



1 



b. 



! 

i 



!■■ 




8 5<u a 8 a 

OCO.00 H « fh 

iklllliiS 




wi si 



| 

lis § $ u 



Nil 



"1 fe 

| i 



3 *S 



s • 

> -p 

o g 






I 



I 

S3 



i. -o 3 -i 

lis! 

-p ja •-! 

• ■&■-« s 

•s 8 bis 

§• J! 

8 o o « 



8«. 



3,2 .-a 
.ill 

O W -H 

5 ti 8 ^ 



&•¥. 









S3 



u 
u 

(0 



- A-126 - 




8 

I 



I 

■-I 

i 



i i 



in 

e 

in 
I 




1 $ an 



| |1 |1> gUil? 



I 1 



it 



$ *i 



it' 

HIS 



I 



1 



I 



il iH 



n 



a 

! 
|i| 

■ -a *j m 



- A-127 - 





- A-128 - 



\ 

b. 



I 

a. 



b. 
s 

H 

m 

o 

I"-' 

H 



3 

■H 

s 

I 

8 

I 

b. 



» 



8-^ 



CO 

8 



s ^fsp 




er 5 .w j3 . 

• i2"28i 4J s 

!•<->_ * <-• to 3 



•J 

1 

I 



*ill*3 



g -53«g'Sl i II 



Set 
o i 



^3 



+• s, 

•H ST 

"8 

o -J 

fcl" 

r 

8. 



i 



5s 



« o 

e 15 

§■0 



CD m 



1 



m 



I 



b. 



0> 

* 



b. 

H 

o 



f 



! 



8. 



js-a 



& 



5 

•H 4J JJ IS 



!eJ^iil€fi 



I 



« p §•§ IS qB i c 



I 



s 



I 

ii 



i 



i 







BOB 

5 » 



" IJr 



• _ S o 

■POEM 

?*** 

10 • i § 
noil 



R W 
_ *> H 5 

£8.8 9 



w 

IU 

w 



Xi 
V 

u 



a 



- A-129 - 





- A-130 - 





- A-131 - 





- A-132 - 




I 



I 



Si 



II i 



0. 



h 

in 
8 

in 

o 



I 



J" 



8; 



1 



H 



5 



:* 



38 



t 1 

8 1 






■* 



a is jj 



- A-133 - 



I 

5 



I 

•H 

i 



3 

I 



8. 

s 

•HI 

I 



! 



! 



e 

10 



I 



I 

! 



a 

5 



a 

a 



3 



i 



i 
a 



i 

s 

■H 

8 



5 

A 



5 I 



I. 

s« 

M It 

e 



o a 

u 



III 

Son 

ilea 



a 



u 
u 
w 




- A-134 - 




rt 




oo 




% 




« 




0. 




l 




3 




1 


5 


h 


« 


1 


& 


Irt 

e 


1 


r- 


*1 


H 


a 


<•> 


I 



E-a 



s 



f 



.1 



I 



o 

4J 



! 



fe.< 



id 



"«|-8 



5 

88 3s 
HBJ 



gg 



JLA """ 1 ill 




u 
u 



- A-135 - 



3 

8 



8 

m 






»s 



to 



« 

5 



S 

"S v. 






ii H ii 

W DIJ9 



5 
I 



J U 



AS 
■J 



fin 

5 2.M 



5 



1 

u 



CO 



a 

r 



C 6 8 8 



a 

H 




- A-136 - 




8 
1 



b. 



in 

e 

E5 



I 

»-4 

i 



i 



5 4 



8 



I * 



<H M 




- A-137 - 




00 



It 
a, 

I 



3 

H 

m 

o 






I 






rt o 



I I 



m 

■3 



3 

|« 



+■ 3 



?1 






- A-138 - 




CLi 



I 



XI 

o 
r-' 



I 



3 ?»S 

Mj ! 

4J -H +J 

~* ** ""* 
I "Si 





o 



11 




1 



o o o « 

1m 

live 
h 8o !3 



ssflllit 



8 



i3 

i 



II 
I 8 

88 
<8 



- A-139 - 



1*3 



0< 



3 

i 



o 



■y *! 



on « 6 v 3 eo 

3 3 8 S.3 8 



5 

■u 

3 



10 

iJ 
S 

8 

i 



!«. 



•a -h 
■ ■° 

b * 



■y 

£S 



IS 



. h In 
sS" -0 4! Si 

■is* 

H U It s 

•H It -H B 

| c ss 






!! 



§*1 w 

j Ml 

(S5S ° 



I 



g 01 



w 




- A-140 - 



I 



' ! 



23 

I 5 



I 



fc 



3 




5 


f 


g 


Jl 


s 




i 

i 

i 


in 

e 


i 


5 


5 


8 


1 



.1 



11 



rH O 

.Q V 



S : 




- A-141 - 





- A-142 - 




- A-143 - 



-A-144- 




1 

I 
I 



o 



v 8 § 8. A Hi o c w « s v 

hah KQ j -oil S >i ft 9 

jdhhS g£Q nog *"i 



>T5 «H 



-- = 8 "3.^ 1 1 "8 P "-• S "5 q m _ 

tj 3Hfeo9iBii4J4J4j|j|i 



3 ecccecccccccccd 

i I l!IIJIIS!IJSil3 

- A-145 - 



m 



I 



* 1 






ii 



e 



i>. \ 



.u g 



g 



n 



3 
?! 






1*51 i«* 8 

»a <m <r> a o 

ails J 5 - • 

S Oil I <M 5 JJ 

m 5 £ 2 il ,„ s -s e » 



01 



en 

« <h u " 8 <m e 
,000 o 
>H e >M »J 

o«n« oh o 



« C C X c t c 






o> 
? 



'A • 

^°S!8 !S 

OnHUoA 



8 



a«:r 



* * * « * * * 




- A-146 - 



I 

i 



! 

i 



3 
! 






a 



tl I 



1 




It H; 






a to $ 

l3« 



r *?| 



tj ti **s sic 



»1 

83* SB& 



o • 



I 



a 

a 
o 

I 

« 






!§ 



ft 



8. 

K 
0. 






1 



h 



r-t 

■8 

I 



& 



•32-1 



4 



aj 




c 



u 



fr 



own, 

ail 



I s - i 



-J=« •« •« 

££2 



SB 

i a m 






888 

4J 4J 4J 



ffi ffl ffi p-l 

Ml ^ 



222 

BUS 



i 



03 



- A-147 - 



! 
I 



i 



I I I 



i 



1.1 ! 

.© g a 

91 



is 5 



3 • fe 
"S3 >-"S 



=3* 



51 i| 



l J 



ij 

ll H I' 



§• * 



! S If L 

lit 3 5 ij 



?€ 

■ 3 



5 

I 




1 



I 



I 

I 

5 



**< 



§ 



J 



-tPi s& * 

* I** I 1 li 



53 ;t 



- Ia :ll 

•2 H4» sa 



I •- laf- 

§3*Jj 
f I ll ||l«3 




- A-148 - 



! 



o 



I 



§ 

M 

! 



* - 



S I 



a 

! 



£2 

3 



M A 

S1i8 



>,r-« 1-1 _ 

,H *4 « -I 8 



1: 






I I 



M«a 

||U|| 

* 5 "9 p 1 

9 -h a o o u o 



!-•« 



J 



Si 



I 4J 4J 

'55 

l aa 



s 



I 



i 



I 

i I 

- * 



i 



! 

\ t 1 



j i 



t 



II 

? 



i. 1 

•a 



.3 * 






to-* 

Of* 

5*3 



22 
* J 



1 1 

S -< u 

5 rH S 

IP* 



JJ *M 



3 



Off 

Mi 

§*5ls 



s° 



llili 



««t in. 



s 



5,. » 

lis-* ^$1* 
Sal tih&s 



1 

<M 

o 



±1 



5 

H 



I 



2 1 



i 



I 1 

w 



£ 



- A-149 - 



i 

\ 







8 


Si 


•a 


ft 




rt 


§ 

■H 


2 
8 




H 


8 


4-> 


•H 


1 


s 


t 


<* 


L. 


o 


a 



s 

1-1 

i 



5 

■s 

-I 



I 



I 



55! 



S 



5 



I 

n 




S 



5 

1 

§ 

rH 
* 

> 



CO 



£2 



tl 



— ■ U 4J 



. II II 



33 



. , 2-.2~ 

ti" i 

*> TJ « .Q 13 « 
« t c r s c 

rH rH fS M <N cs 

TTTTTT 

HHrtHHH 

^ 5 ^ 5 5 5 

<S pH i-4 »-t i-* rH iH 

•s^-s-s-s-s 

V 4-1 JJ 4J W 4-1 



J 




- A-150 - 




! 



a 

0» 



£ 
I 




3 



<" 

"" o 



o a 



-i 



s • * g _ 

tajiJl 



OH 



3 

•H • 

6 ■* 



§8 



lis 



M 3s 

5|||p __ 






I 



tj- 



o 8. 



S 






- A-151 - 




- A-152 - 



Du 

g 
ii 
1 



o 

5 

o 



If s|$3$$ 

ial-s-6 s s s 

w>>sSsxs 




- A-153 - 






I 

■u 

■H 

! 



o 

H 



I 








2 a* g 





8 T • >. °* 0> .5 

mriii 

— fee • S"? 
^■■oSlJlt 

• 1** s-d-a b • 

*-* ch? « 8 3 * 

0»9 5«. >B, 3S 







•w-jc^oB<« n 3'a 

b 1 8. g g I -3 a §•' 



a. 



5 






3 



■H 

I 



3 b 
- I 

1 & 



♦.US*?"!-! 8 * 

IllSjilS" 




« £-. 



i 



Si 



ill *> 

■2 b o >•& 



| 8.1 



4J <M , 



iris b li 

is*** J! 

■*iir* 

s _ c ii a s 

J §,« S i 

1 5 I" • 3 *•* 

5 , S"2 W - B> 




i-5li| 



.0 .1 I 



•o 



. 



3 

3 
2 



3 






- A-154 - 



On 



S 

1 



o 



I 

I 




M ° $ 



&3b 

4jf 0,1 

5 o * §" o -5 
H i. 5 $ +J * 

"H -H *0 06 I 



o 

n eh ' 



ilgi Mt I |s| 

rf'lJilM gj 1 !! 

C a v. 4 4J S B<* a B jj £ 
ucwo-tJ^-'Su-a i o 3 

k ai*ih*t**i,?L 

•oU-rtougce -h oS £ . 



{X 3 -^ rt 6 



i3§ 



fc --*^£ p £i 



w o o p 



t U Oh h£ U iabu-H B jj 

■HDtlK ••HOllOtJ 5, O IS 

rtOa id » » « >,o -SPw 

jllllsriHilfhi 



«fr 



83 



K O 

is 



9 T5 

C 5 



3 t. 
O 
J. JJ 



•I 



I- 



r 



o 

c 



I 

8. 



,1 



o 



a 
a, 

I 

i 
! 

8 

*T 

O 

r- 

.-t 

m 



n 



- 1 S 

°i It £ 



si 

0* 



8 . fl I s 




— win, 



ii 



n 
8> 






I <M -Q «H <M O 



;A 



- A-155 - 



! 



I 

g 

■H 

a 

i 



o 
m 





£1*1- 

i** . 

at) . J 4J 

l.i£ , ]jI J B*i t k 

O V. ft UlC oil 



-lis?" 



b 



g\2 8*' 






J.I HI 




§ 



« c S c U -d 5 

sf-SSil-d 

p 5 |* J « 



s*: 



i,e.ol» 



! 5fc 






■S*tJ8 

_ 0> 1 f* £ 

a c^-i oi » * 

ito?f 



■u 8 



j 5 "3 b 

J3 3t 4J -H 




I 

I 



.1 



,5 



u 
w 
w 



1? 

ill 



0. 



i 



5 



ss 

leg 

jjt.1. 

•H M M 3 

JssJjg 1 

gSS.p-.q-8 



O _ „ 

■u -y *j 



5 

8.8." 

I .. .. " ■ " 

ill!!* 

r.*J -y *> *> a 



,i 



- A-156 - 






3 
JJ 

5 



o 
o 






8* 



■0 ^ 5 -J • JJ 



r 



a 8 m a ih jj 

— I O 04 HC 

- 1 d _• -d o o 

•lili jj i. 

3 Bh «< g 

« i • s ■? a tl 8 

8531 V*%* 

8 C ( il » 

n i <w a i mil 

9 b «-* u c o o 

g JH o 1 " 8 J> 




8 «- rt 

jj en -1 

•o 5 « " H « 

-J -r-l 

{£•* ■OrtO 
3 »H 8 -H Q 

» p. is ja m u 

S3 

H $ ' U JJ 

a. _ Lti i 

•H « JJ 

~ o 
fa. 







JJ 

A 
N 



! 






« o _ _ 
o^tJO- 

u jj aasC 

•go" ' 

!|f 8 JS 

l 2 O DU Z M 



I 

i 






°8 



3j?^ 

SUSS 

$«« 

S£ 5 5 3 

fa ? ? wu 

355*53 
§ M w 35 g 

o C jj jj mu 

L JJ X X JJ JJ 

3 tt d a b c o 

JJ H H 3 5 JJ 
O JJ -H -J * O 

C 3 JJ JJ 3 > © 

jj£ c fc p 5 i: 

TJH tt U 

C O OH ffl 



■H £ CI 3 3 



JJ 



0*0 

■o 

C 13 U 

- s .i 

all 

05 

Ik 5 

lite 

a:* 



■-< J3 

>.!> e 
it </> n 

MS 

ID U 6 
•H Q, 
Q JJ 

■o 5 ■& 

8 W «H 

8|j 



w 

3 



18 6 L 

fl U V 

!= m S 

S-JB-* 



h*3 



i*te 

J* 3 

814 

a 
is <m 

■H i-i -H 



Jl 



■H 



I 



2 



o 

>. 

t-H 
JJ 

S 
I. 



is. 



jj jj -i 

525 w g 






I 



I 



8 



If 



I s 

1 



JJ L -J, 3 



8 S's, 



JJ B M XI 

- J -J 3 I, 0>Q >h w 

& -Is = a . 

3"tj 5 -a s d o -j 

a 8 &• c o> 5 jj -o JJ 






18 



ail 



»i;jrtll 



jjj^feo 
8 -a it jj 

■ JJ W O JJ 



oiX'2'BejJt 



■3 ■» o ? _ 



t! r* I "2 a n _ 9 1 3 w C 



^gjj' 

11 8 




£ +j u a f S 




^J? 

sic ' 



u 



8 jj as 
sic 

> JQ 2 H tt tt 

Sjj u e -h o 3 

ae« . 53 tej!-o 

1. d L ■" «) ii -I 

§ .^j?«-<S^ 

l|3i -111 • 



8 jj 



u 

■y j 



"5 

ffl u 







Sfe.*^ 



9 JJ -H 



> JlMH-H >,lH C jj > a 



- A-157 - 



I 

On 



a 
■p 



I 



t 

TJ 

C 

I 



% i gi 




t 



is 

■H 4J O 



-. > — U i-H 

U -H JJ A 

5 Si g -S 8 &•> 

B*iH (S 3 S * 

•y ej "§ ffia J w w 



1 5- 



if i • 



5 



-Jfl 



f 



8 

•o 



■3 ^i J 9=sfil° -a 1-S 



•hr* 



l 



> u 

I CO 




- A-158 - 



i 



I 



H 

in 







ii 



5 
1 ° 



w 
u 

10 




- A-159 - 



1 



.2 



o 



I 



I o 

I u 










I* 

5 3 3 *< e jj 

bftll'S 

a 51*? la 



i a. 



5^3 

CIO n 

<« « » t B,iJ +> 



1 



3 


2 

I 

8. 

« 
ii 

J 



•8 I 



Ii 



c 



o 
u 



s s 




- A-160 - 



1 



! 



§ 

■H 
JJ 

■H 
9 






i 



i I 



§ 5 



I 

8. 



r-t 

I 



o 

I 






s 



a 

■H C 

<a JS 

•H V 

o Z * 

s 8 , 

his 
8* 



Mi 

I- l-l .H 

fl «-l iH 

S-28 
III 

•H M -I 

■H ■* 

111 

•-* o 

HOC 

a!: 



S3 

35 



§1 



ft 



a 

P 

> 

Is 

b 



I 
1 



I 

o 

3 



3* 




- A-161 - 









•.SB 

O _ _ 



§ 



<J55£5 



w 
w 
w 



£ 



I 

s 

■H 
I 



r- 

.-i 



I 

r-t 

I" 

a 



! 



I 



2 
S 



* 



•o 

4 



e 
■y 



! 



* 



£ 



! 



* 



■h c o 



5 

* 



1i 

i 






hI 



It 
!3 



Jl 0> 



SIS 



IBB <u -O 



3 iu 

I M 
i *• ■"* 

! I3 
jj a 

»• P 



I. 



2 
I 

o 

■P 









It 

o u 



\&H 



tt&l 



> o V 

v - 



< 



1 IsUh 



IP 



» 






« _ _ „ 

• •jj • 5 -H <• 4J 

r-H B -H 8 « -H $ 

> in <« „ a u 

(0 .. 

' 



It 

f 1 

S 



• £: 
S3* 

OCX 

413J 
? & . 

hi 

• • 4J a) .S 



X* 







if! 

II 81*1* 

>» w c w o 

A c 5 10 o 8 t. 

B "g » > ^ S " 



I 



5 
I 

> 



ill 

•U 4J _ _ 



•y ° 
6* 

■fl &• 



If 

2l 



2« 



9 o 

c 



B I 



« • 8 g 



w 



. . . u w 

«J3Cl, 
« 1.1.x 

n *i _ 

3 10 u ■o 

•P < -H 9 



S" 1 <5 "S 



w © 

A 

l b i. _ 

»!ictfl 

j &-H r-l 

U 3 >, 

I e 1 ■ - 



1 a a 



1 « 3 a 



I« 



O C 



8.1 
11 11 



- A-162 - 



i 

I 



! 



o 



i 



■3 

■H 
i-l 



4J 

■8 



■y 

I 
I 




8 3 pg-ll^l 



4J B Tl -0 I. 



US 

IS 

I* 



±> W Cu 



n 



!! 



8 « e 

jl ■ 
igg 

Mb 

<« -H L 

TJOC 
< 

J 1 " o 3 

Shuk 
CO 



M 



! 

I 



a. 



H 

o 



* 



I 



OO 




5 

5 



*H 
*) <M 

fcJS 

a? 
S a 

- A-163 - 



,1 'I 

i tu 

! W 

I VI 



a 
0. 

8 

TJ 



3 

s 






1 



1 * 



8. I 



! 






I 



I 



«5 



Si 



*"*8- 






I-H3 I 1 



*s 






8»£ 



SS°3* 



8 l B t! 5 



* d$ij 



mi 



*2 






I 8. 1*1 



1 wi |i 



e >-• •< ■§ 

!i S 



• § 



MS 






1 § 



I f 8> 

J; M 



$ i $JiH 11 i *i 



S _5 



Oil 

•u i. j5 « 

"•6, 



.sis? «!•: 55 *« 



S S38 

, O O >M 

! 4J _ o 



I ". ii 



£ 



5 

a 

O <M <M 

5 8*S o ffl 

l « M J E-c S Z 
01 



i 31 



■5 




I si 



K<H 



Q 04J4J 









8- 

s ° 

35 






III' 



a S. c , 



2 14 

5 g g 



111 



s 




jj 



II 



1 i] 

§ :>■ 

b v 



I 



I -5 



TJ •O 

C a -o 



WWii! Illf 



J 11 



01 

fa 1 * 



IJlSjr 9, 



- A-164 - 



I 



o 
n 




a 



a . o < o 



w 



i 



H 

3 



I 



5 






1 



* B Tl rt "H 

££|3£ 

"g » 8 
8 c 9 g u 

3£E* 







I? 

1 M 2. « I J5 

ill js 



£1 



■J3 ffl J- uj 8 

•pJSSq.*! 



«"SJ3o5J 
84 !§*•? 

S n (fl o Ui 

1 ? «*• « sr • 

I 1. fl H l<MU 

J £-83 S x +jP5 

w Saw 80 " § 

C 7] 3 ^ 9 
] U IK Q, •£& 

3 2 s.3 t uj3 



■go 














in 

II 9 

ill 



S 



- A-165 - 






■3 
5 








j V 'M fH 



nn«f 



S « •'6 •>, 



• 4J 



. - - 1 J 

a g Sos 5 



a BJj 



i 



•i * -8 8 

JO L L 

! "o o 



-i 5 .u 

s 



J, 

DP 5 8.0 S So 





- A-166 - 



I 



1 



I 



to C >. >. 

<fi J" <M -H 

! \& 

fro » 

« 4J -H 

O a -h ■n 

CO >. 2 S 

US l-c 4J JJ ft 



-J 

8 kg « 



^ 



l . 

•H « C 

-H JJ <u 

a, a i-i 

B « 8" 

«J 

"H c o <• 

«8£S 



« 



£ Q"4J 



g 4J J3 



-J • 

Mi 

U B 4-f 



rt &8-: 



. 



*1 



_ 9 



J *1 

o 8 4J 

1 I! 

• BO 



I 



fa -H "J -5 
4J -H IT 

53h 8 

II C S 

I II 



1 

8. 



« 



a 



8 §1 



w 
u 

03 



On 

s 



O 




|Jll hit 



- A-167 - 



3 




I 

to 



1 



o 

I 

1 

§ 

o 



5 

a 



i 



i 

1 



0. 



• M 5 « 



a 



to 
u 

CO 




- A-168 - 




! 



3 



5 




>& 



- A-169 - 




8 

I 

i 



■S* a -a : 




i«2 



5 



** sii 

&* 5 8 8-! 



4J • . lu «" 
,2 o S 25 c 

So *£8£ a l 




9 9 ia a, '" y ^si 






tjJSCllH 

P JO . B •H rH 




t! «►) £ H ? H ** *i -H J3 CO 

<9zil£ a 5,3 £ 3 u e a 3 .3 

3 -H •* -l m O 3o-*MM S.5 -i S B 



•y e 



55 

I a 4J 





*! -y 



3* 

5 4-1 o u 

<" •-< 3 C -c 4J 

o >h u m -i 



Si" 



...8 k 

Sea 



o» 3 5. -283" £15 
4J &4J on "0 

Bj E TJ JJ >■ * rf 

SI. Q iH 9 . 9 e 9 9.3 

1 H-IM • 8 « M &\<5 
S »-< ~t JC £ rt 

So** - «• 



I 



9 

if 

4J 

o 4 

4J — 

1*1 






lU r-l 
^ & J5 

o -w 
a. a k 
m a 

•*; 
p !Jf 






. a a 

•H .-I > 



- i _ TJ *J iH .H rt 



5 



8&JS . 

« « c 

o«io 

OS n 

veon 



: ih 
»° = = 

9 « 

u o M 5 

S- > C 

•T'C *> 

U >, U -I 
« >H 3 « 

g f S 
P« C 4J 

V? 
h5§5 

-sa* 
its} 

§*zt 

5 | an 
o >Q • 

Eu 




- A-170 - 




I 



I 

On 
I 






I 




w 



!1 



- A-171 - 



I 



o 




3 

5 



I 



I* 






i b &5 

S3 



+J 



:<3£ 



fcJ o 



S 31 



I* 



I 

4J 



5 

in 





lj ill! 

5 * 



855 

■3 u X 

!|! JiJ 

9 „ 9 9^V 

m im 




\\flt 

* a * 

« alii £ 

a 3 8 1 8> 
•p -p <S t 
•2 « » 

ill! 



W +J S 



s 



M 

!8S 



:?2 



[III' 

Jfijl; 

Elljlf 

1 1 1.1 II 



x >. 



?•§•§ 



oS: 



■DBS 
5 o o 

2 4J *> 

m 

Bbb 

"18 

' g g 

OHH 

8 



8. W M 

II II II 

, "6 +1 4J , 

LS'S'S 1 



- A-172 - 



J 



s 



o 

5 




ID 
U 
CO 




- A-173 - 



J? 




in 

1" 



it 

04 



a 

3 



i I ill *i 

1 ! Ui l« 




- A-174 - 



1 

04 



3 



o 



X 

I 
1 




*■_ a _ * 

•1 >-< 5 
+j t) v a o 



<5S<38| 
gill* 



• « 

O gi i 

is 
Is 



<M 

is 



5e 



'5 
I 

5 V 

r 

a 
ii 

1 



.*.% 



n da ne 

* <H "O •? 

*i V 3 » 

J J Hi 

•s asi-s* 



li 
* 






OIL 



""MS 
















XT 

>»rH ig 



". ri -1 M c 






jjf 5 
Jj 

II . _ 4J . 



fi3" - 



! 
a 

! 

s 

.-I 
o 



9 Is 
-I «§32li 



la 



iPi ! 



fr'fr* 



h Uvi- 






8 









«gw* 



a.* 5 



2 



,-S 8 

) «M <W A 

[MM WK 



I 



A-175 - 



I! 



a. 

o 
o 
•o 

s 



1 



lit 




6 « i3 ■* e g U -3 •• 



I 



&«j»*ss S8 £'ii'l 

■h o > i-> «* j! 

»&<,.*» fi« s PS* 13 



■O -H B 



nota 



trP 85 8 « 2 a 2 






i 



o 

H 



di 



^ w J5 



» H 






I'll* 

"IBs 



k!§b8§- 



8».ia5 8 a «.§8'sis , a|gB 

•p 5 Ob i o>h >..Sfl-S5Swi» 



alriag5:il«Si'Mj| a Hii;4 




- A-176 - 






3 

s 



H 







a. 
I 



O 
I* 




el 



1 



llihii 

9 <& 9 J3 C f 




|8i 
•Is 



3. 1(1 I 

I'll.*'! 4 i 

1.-13 fri-i +i s B. 
a* yJ^sB* 

thhsh 

5 fi _ S- g> »rt o 

„. _ f ■" •■* -i ~ K 

Isaacs* 
5-11 l* a »B=S 



^ 8 




"5 



* If 

9 3 A W S _ _.. 

•* *i Q* 






s 3 



o ' 



§ 



&S-2 B 9 ..« .. S-! 2 * S » 



Oi*H C E 3 O 

« (IS OH HU9£ 



S Bi 3 



2 d 



PI 

<M 



J£ 



3 § 



8' 



4J a B 
I 9 i- i 






CM ..... 
■H 1. I. JJ C 

C .... _g|S£^| 




Ifl* 



II 






• ■OB U jjl *" 

01 ' -I Ci n J jj § 
ffl "O V D»"w W i-( -H T3 

MOOS -3 M 4J X 

•■ 4 U 4J M ij T3 >.« 

6 0.-H -H C >Hj 

• ><o*j>-i*-Hc!r 

lu^ ch u 3 a; •p 

• HI M rt » <w © .. 

'3^ s .US ?>■» 9 

: >■■*.£ r-i g *j «j 6\ g *j 

■q 8* 8*H S M 8 H ""' 

• -H 5,5 >.H • • 

ri«— * z *-» > b 

l<4H <-* -H -H 3 O H JJ 
' * -H • -( > 4J & 3 

4J^«-H^.3 J5 3 4J -3 

liJ-rtoSaSBSoc 



l hi 

O A 
O N -5 



"Is 



§2 

1*1 



3 . 
O 4J 

*5 



5 



pin • 

his IE 



- A-177 - 





- A-178 - 



i 



! 



H 




P>MTJ-H+J 5 



5 <m - - 



O *H 



o 

* -, 

21 g ftS-S 

t 9 * TS V H 

■|J ,% * 

IB 3 <w 
5 <■« "VI 

lu » III -H "O-O 
<n erf 3 

Ii|y|i 



I 3 iH *> . 



■y b * n .£ 5 



2* 



HI 

£ S5 



"'ill- 



n 



O B 

-2J2 

* f< 

ua 

Is 



M 



■ i * 



in 

35 



J5§ 

5 $ 



•H 0) 

12! 

tu £> 

"I 
gf 

Z (9 



II II 



5z 






3 



8 

i-t 

o 



M 

i 



! 



o 

4J 

! 



I 



5 







§ 38 

(SB SB 

i M 

l W 

I M 



- A-179 - 



i 

§ 



o 

eS 

m 




I si 

o jo 



CO 




- A-180 - 



s 



I 



3 
4J 



H 
O 




_ o a _ 
. J5 S S3 

1 « -H -H (0 *> SB 

iJ! UJJ-j 0*JrH-H 



"lis 




O C ri I | 
IM u 5 O O Q -i 

10 OS 9 -H J2 O -H 

■W £ V C -H ,-* 

■ — B "9 fl * 
•h o> i i-i $ 5 a 
_ « m ^i i-i 5 

3 t-4 o 04 

t^ 8 * a -» a 

V v £1 3 C 
a 8 53 tn 5 u 3 

5-1 - -3 p 3 4J 

rllPl 



1! 



*S 



So. 

« 5 

V ID 
B 

O 

OH<U 

!>: 

«a a 






ft' 



1, 

si 

ill 



i 3i 



u 
w 



R 



I 

g 

-4 
4J 

■H 

I 



© 



So 



• fa 



I 



« §5>8 






6 *M 

w- a in 

v in 
B -H o S <o 



* 3 



5<M «^H 



5 j • E.S 1«4J 



|«ai «. 





u 
w 

CO 



- A-181 - 



I 

H 

s 



1 

o 



I 



I 



!«S 




1 

5 



I 



I 



Is 



fe> 



w 

• 01 




- A-182 - 





- A-183 - 





- A-184 - 



I 



8 



i 






s 



5 



1 






I 



5 



i 

! 

1 

s 



lis 






3i£ 



Sp 



•8.3 >, B 5 

is **i p 

JeSe 3 5 5 8 

V H 3 *J ** 

Hi != *lU 

a J •S * uaiS 

in > rijl 4-1 5 

5 +j 5 ijh a a <u 

3 -H *J 4J 3CUO 

|* S j.jjS p» 

i J f|l| 

it* M 

i n Ji 

1 18.31 



U; 




si 



2 



vo 

! 
i 



s 



i_J 






* a o c 



s a 5 a H i r$f 

I*. 8 °B* J ±J b 5 5 H 

til «5»s1«. 

SBb fr b8-lBg^ fl . 

_ C w *J lu 4J *5 «-» B »e 



01 ! 



•U 

1 : 



§§ 



n 

-1 « 

j; 

£«« 

5 « -rt 

■2 ti * fa 

Mr 



HI 

o 
I 0.CU 

i£3 
ill 




3 K 



8- 8- 

,1 



'••■■11 

e o 



\\A 

ill 



II II 



:££ 



Si 



- A-185 - 





3, 

CO 



- A-186 - 



u 






I 

I 



s 



!> ^ 







* B! IMS** 

l> Q> Gfi*S o S. 



I 

3 






1 

! 

1 
s 

I 3 1 



I 



II 



! 

i 

S 






I 



u 

M 

to 




- A-187 - 





- A-188 - 




2 



i 

8 



5 




o 

z 



- A-189 - 



i 



I 



5 




- A-190 - 




& S Si o 






>> <t <u O 



1 I & 

P. .«• - 0,0 6 



s 



i ill i! ti ! iili ill! J illlh 

■ 1123111.1533,355 ?3 .3 as a Ills a 

•d-3 9 9 &£r<P 53 3 3 3 9 9 3 o ts ar o o o £ fl 
m a 4 « i- > e -h c « c o 8 5 _S 5 fi o J 5 2 e c c o.£ 

i 1 iliiiifeiiilliteillllli 

8 |||||J||^|||||||j|J||||J||| 

1 flltltHlllUllllllllllI 

- A-191 - 



i 



in 



I 



I 

to 

I 



1 

8 



l 



\ V 












l I 



ti 



to 6 



J 8 

i|j li 

it C U* 

O O O tf -H 

llllli 

8.8.8. 

n " ■ m 

■-• J3 J3 <m x x 



A 

I 

% 

o" 

x 






t-JIj 



3£ 



ItJH C 






i 



h o a B 
9 •S'2 S>"9 



25 a " 

Jflftjfrl 

o| o 

fa's 9-s * =» §■ 

B 3 c ~< a 

jj. Sign 

iHritf 

a as 3 5-. iJ 
3<m <w5 o 5" 



5? 



**! 



10 



I 

I 



a> 



i 



i 



i 






!- 

o 



M 



1 I $ 






IBflf? it 



row ;i 



Si UrH B-* 

sHt fi 

jj » ^ -h -g j -g 



| 
I 

I, 



ifr&sf k*-* 
}* |c 1.1 b 

55 • ij'- , .5' H gj*J| 

a o ph a, 

2- »|5S8 M-M * 

i S S3 






Ii 



- A-192 - 



I 



cu 

I 

i 



in 



pi 

! 



S 






| 



i 

& 

c 



Ilk 

P 
&8, 



f-4 
I' ^ 



5 



g 






ii ii in a 

-All"* 

l J IK! 

•n • J- .Q 9 



II 

I 

I I 

- 8 



lu 



i 



M 
U 
03 






X 

O 

in 



I 



I I 

-! ft 

! § 



l 



5b 

I r 

| 1 

! f 






ft* 






I 



I 



J5 



.itui! 



o 



a s 



jilli 

"H r-t 

<M ea >4 

tllllJ 



^1 

9-4 

WVJrik 

fa fa fa o. 



GL Q* Cb 

II II II 

" " • i^ft 



A 



03 (8 



jfij! 

+» 3 w 

^8.1 

•3 S & a, 
3 



2 a 



S 



Ills 



^3 



- A-193 - 





c 



i ! 



2 



I 



I 






r 
h 

u 



!5 



- A-194 - 







3 













<M 






e 


o 

H 




1 


% 




3 


a 




e 


0. 




X 


& 




i-i 

4J 


u 


n 


•H 


i 


k 


c 




3 


t 
1 




-i 


a 


s 


e 




O 


$ 




in 


4 


■a 



! 

(0 

c 



I 

8. 
ii 



5 



Si 

8a? 
m 

W P rt 

.1*5. 



■3 s" « 

rt H j5 



8 



1. 



l! I 



s 

to 



0. 



It 

M 

! 

i 



c 

! 



5 
B 

c 

! 



rH It 

c 



2 * 



c 



5"o J} 



£ 



1 
8. 
ii 




£2Jr 
2 8. 

[h 

> O <M 

3* 



3 



31-2 & S ^£ I 

• tSSoUBB- 
Stu g c 6 oiJSp 



B< 






5 « S 

HtH 



r( 



•a vfi 



al^b 






III 



« 8 v 



- A-195 - 





- A-196 - 



2 2 



& 
? 



§s 



1 



.1 






1> 



£3 
-3 



! * x >. 



fli lit 



_ O O 

O 4J 4J 



H 

■J « ? s 

o o 

+» *> o o 

His 
„ .. " " 



i 



5 5-5 

2 



.Isl 



I 

i 



8. 

a 
0. 



I 

•H 
O 

in 



! 
i 



i i i 



I 



I 



I I I 



c e 



I I* O 



a ?* 



I 1 

w « • Q 

i i 



S 



- A-197 - 





- A-198 - 



I 



s 

s 



i i 



! 



i 



^ 1 






-< a 



I 



n mm 



as r^ 



« (8 10 



B a 

■si 



3 



g«s 






o o 

4J V 



11 



o o 

IK** 

•J? -3 r-l r-t 

S.8.-8-8 

ii n ii it 

<H iH fl 'S' 




M 
W 
CO 




- A-199 - 



ft* 

i 



in 



I 



S 



I i 



2 
* 

c 



I 

8. 



SJTa 

1*1 

■H b 5 
i-iO* 

« -rt im 

l" 



BO 

Sd" 

M C 






i 

In 



HI 4 






El 



£ 



m 
£ 



r i 







a 

- A-200 - 



1 



in 



i 



s 

1 



I 



I 



B 

M 

1 



3 5 «5 



! 

a 

B 



5 
O 



5 

a 

ii 



4 * 

**! I IS 

it SHI 






o£ 



ri 



3 U -h rt 
jlfJ 

?S fifi 1 mil 

: « tj 3 3 a 2 » l» *j « 



i Will 



c 



£ 

« 




- A-201 - 





- A-202 - 





- A-203 - 



A-204 - 



Appendix B 
Device Summaries 



This appendix contains Unix-like summaries for the commands that may be applied to ROM 
(or kickstart) resident devices, as well as summaries of routines in disk-loadable devices. 

These documentation files are organized oh a device-by-device basis. The tutorial sections of 
this manual give you information that shows how these device commands relate to each 
other and the prerequisites for calling them. 

To use any of the device commands, you must first open the device. The correct calling 
sequence for opening each device is shown in the device tutorial chapter itself. This intro- 
duction lists the names of the current set of devices that are included with the system. 

If the device is disk-resident, it gets loaded and initialized. The OpenDevice() fills in the 
io_Device and io_Unit fields of your I/O request block, thereby tying that request block to 
a specific device. When you say DoIO(IORequest), the DoIOQ routine, among others, 
looks in the IORequest to find out which device is to be used. This prevents having to 
have a complete (duplicate) set of I/O transmit and control functions for each device. 

The following is a list of the names of the devices currently a part of the Amiga software. 
All of these are to be treated as null-terminated strings, given to the OpenDevice() func- 
tion. For example: 

error = OpenDevice("keyboard.device",0,IORequest,0); 

See the exec.doc summary for OpenDevice() for the meaning of the various fields of this 
command. 



Device Names 

audio.device 

console.device 

gameport.device 

keyboard.device 

parallel. device 

printer. device 

serial.device 

timer.device 

trackdisk.device 

When you have finished using a device, at the end of your program, you should close it 
using the CloseDevice() function as follows: ' 

CloseDevice(IORequest); 

You must also free whatever memory you may have dedicated to the device communication 
before your program ends. Note that you must assure that the device has respond^ a of 
your I/O requests by returning your IORequest blocks before you attempt to close the device 
or deallocate the memory. 

L fc ,?7 yStem * T 11 -^ ° n l 0( mem ° ry and needs t0 free U P s P ace > * can <*«* ^e accessors 
field for various devices. If you have closed the device, it decrements its accessors count 

devkl Jhad useT * aCCeSSOrs vaIue b zero - the s y stem <*« retrieve the memory that the 

Certain devices have routines associated with them, and can almost be treated as libraries 
The devices that have specific interface routines are the timer device and the console device' 

ableTaTe r ° UtmeS ' ^ mUSt ' "* ^^ * ^"^ Pr ° Vide * ValUe *° * Specific Base vari " 

Device Base Address Name 

timer TimerBase 

console ConsoleDevice 

To get this base address, you must open the device, then copy the io_Device field from your 
IORequest block as the base address for this "library" routine. Note that unlike libraries 
you need not issue a CloseLibrary() command after using the device routines. The 
C/loseDevice() function call is sufficient. 

An example showing how to obtain the base address for the timer device is shown in the 
Timer Device" chapter in this manual. 
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AbortIO 

AbortIO 

AbortIO 

AbortIO 

AddHandler 

AddResetHandl er 

AddTime 

ALLOCATE 

AskCType 

AskTrigger 

background 

BeginIO 

BeginIO 

BeginIO 

BeginIO 

Break 

CDAskKeyMap 

CDAskKeyMap 

CDInputHandler 

CDInputHandler 

CDSetKeyMap 

CDSetKeyMap 

CLEAR 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Close 

Close 

Close 

Close 

CloseDevice 

CmpTime 

CurrentReadID 

CurrentWritelD 

DumpRPort 

Expunge 

Expunge 

FINISH 

FLUSH 

Flush 

Flush 

Flush 

Flush 

FREE 

Invalid 

LOCK 

Open 

Open 

Open 

Open 

Open 

Open 



audio 
serial 
narrator 
parallel 
input 
keyboard 
timer 
audio 
gameport 
gameport 
timer 
audio 
serial 
parallel 
clipboard 
serial 
console 
console 
console 
console 
console 
console 
audio 
input 
serial 
console 
console 
gameport 
keyboard 
parallel 
serial 
narrator 
parallel 
clipboard 
audio 
timer 
clipboard 
clipboard 
printer 
audio 
clipboard 
audio 
audio 
serial 
printer 
narrator 
parallel 
audio 
printer 
audio 
input 
serial 
gameport 
narrator 
parallel 
clipboard 



device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 
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QpenDevice 
OpenDevice 
OpenDevlce 
PERVOL 
Post 

PrtCommand 
Query- 
Query 

RawKeyConvert 
RawKeyConvert 
RawWrite 
READ 
Read 
Read 
Read 
Read 
Read 
Read 

ReadEvent 
ReadEvent 
ReadMatrix 
RemHandler 
RemResetHandler 
RESET 
Reset 
Reset 
Reset 
Reset 
Reset 
Reset 
Reset 

ResetHandlerDone 
SetCType 
SetMPort 
SetMTrlg 
SetMType 
SetParams 
SetParams 
SetPeriod 
SETPREC 
SetThresh 
SetTrlgger 
START 
Start 
Start 
Start 
Start 
Start 
STOP 
Stop 
Stop 
Stop 
SubTlme 
TECADDREQUEST 
TR_GETSYSTIME 
TR_SETSYSTIME 



audio 

console 

console 

audio 

clipboard 

printer 

serial 

parallel 

console 

console 

printer 

audio 

serial 

console 

console 

narrator 

parallel 

clipboard 

gameport 

keyboard 

keyboard 

input 

keyboard 

audio 

input 

serial 

printer 

keyboard 

narrator 

parallel 

clipboard 

keyboard 

gameport 

input 

input 

input 

serial 

parallel 

input 

audio 

input 

gameport 

audio 

input 

serial 

printer 

narrator 

parallel 

audio 

serial 

printer 

parallel 

timer 

timer 

timer 

timer 



device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
device 
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UPDATE audio device 

Update clipboard device 

WAITCYCLE audio device 

WRITE audio device 

Write serial device 

Write console device 

Write console device 

Write printer device 

Write narrator device 

Write parallel device 

Write clipboard device 

WriteEvent input device 
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Appendix C 
Resource Summaries 



Resources are software entities in the Amiga Kernel software that enable cooperating tasks 
to gain exclusive access to certain parts of the Amiga hardware. 

There are four resources in the Amiga system: 



disk allows access to one of four possible disk units. 

cia allows you to access specific bits in each of the Complex Interface Adaptors. 

potgo manages the bits of the POTGO register. 

misc manages the serial and parallel port register bits. 

Each routine for resource management is outlined in the summary sections that follow. 

NOTE: Resources need only be used if a user is attempting to use the associated hardware 
directly. The system software routines utilize these resources internally when they perform 
hardware operations. Tasks that also utilize these software resource controls will be compa- 
tible with Exec and the system software. 

To utilize the routines listed for the resources, as with libraries, you must first open the 
resource and assign the value returned to a specific base pointer name. Here is a list of the 
resource names and their associated base pointer names. As with libraries, the name is a 
null-terminated string: 



Resource Name Base Pointer Name 



potgo. resource 
disk. resource 

misc. resource 

ciaa. resource 
ciab. resource 



PotgoBase 



< user-defined > 

< user-defined > 



none provided, for asm language 
programmers only 
none provided, for asm language 
programmers only 



Examples: 



struct Library *PotgoBase; 

PotgoBase = (struct Library *)OpenResource("potgo.resource"); 

/* then use the routines provided */ 



/* < user-defined > example */ 
struct Library *myCiaPointerA; 

myCiaPointerA = (struct Library *)OpenResource("ciaa.resource"); 

/* then utilize myCiaPointerA as one of the explicit parameters 
* for the C language calls to the resource routines. */ 
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Appendix D 
C Include Files — ".h" Files 



This appendix contains the C-language include files that define the system data structures 
used by the ROM (or kickstart) routines and the disk-loadable libraries. 

As with the documentation files, these include-files are organized on a functional basis. In 
other words, things pertinent to the exec are listed under "exec/something.h", things per- 
tinent to graphics are listed under "graphics/graphicsitem.h" and so on. 

This appendix is a hard-copy of the "SYS:includes" directory on the Amiga C (Lattice C) 
disk. 



Dae 9 13:55 1985 C-Ineluda-Ella-Xrat Paga 1 

Cress Rataranea Utility (C) 19*4,1985 Co— adora Aalga, Inc. 

l:dietlonary 3:ad>d»ita.h 3:alarta.h 4:»udio.h 5:bllt.h 
6:bootblock.h 7:ela.h 8:elip.h 9:ellpboard.h 10:colUde.h 
ll:conaola.h 13:eonunit.h 13:ceppar.h 14:etypa.h 15:euatoa.h 
16:dec.h 17:davlees.h 18:dlak.h 19:dlskfont.h ao:dlsplsy.h 
21:daabita.h 33:dos.h 23:doaaxtana.h 24:arror.h 25:arrors.h 
26:axae.h 27:axacbaaa.h 28:axaenaaa.h 29:tentl.h 30:gaaaport.h 
31:gals.h 32:g£x.h 33:gtxbaaa.h 34:gfxa»cros.h 3S:gr»phinC.h 
34: icon, h 37: input, h 38:lnputavant.h 39:lntblts.h 40: interrupts. h 
41: intuition. h 42:lntultionbasa.h 43:lo.h 44:losl.h 4S:keyboard.h 
46:ksyaap.h 47:layara.h 4B:librarlea.h 49:llaits.h SOilists.h 
Sl:aacros.h 52:aath.h S3:aathtfp.h 54:aamory.h 55: else. h 
56:narrator.h S7:nodaa.h 58:parallal.h S9:porta.h 60:petgo.h 
61:prlntar.h 62:prtbaa«.h 63:rastport.h 64:regiona.h 6S:realdent.h 
66:aarial.h 67:aprite.h 68: startup. h 69:stdlo.h 70: tasks. h 
71:taxt.h 72:tiaar.h 73:tr»ckdisk.h 74:translator.h 7S:typaa.h 
76:viav.h 77: workbench. h 

A. 14- 50, 14-51. 23-105 

ACCESSJtEAD. 22-38 

ACCESS.WITE. 22-40 

ADKB.FAST, 2-21 

ADKB_MFMPREC. 2-17 

AOKBJ4SBSYNC, 2-20 

ADKB_PKECOMP0. 2-16 

ADKB_PKECOMPl. 2-15 

ADKB_SETCLR. 2-14 

ADKBJJARTBRK. 2-18 

ADKB_USE0P1, 2-25 

ADKB_USE0V1, 2-29 

ADKB_USE1P2, 2-24 

ADKB_USE1V2. 2-28 

ADKB_USE2P3. 2-23 

ADKB_USE2V3, 2-27 

ADXB_USE3PN. 2-22 

ADKB_USE3VN. 2-26 

ADXB.WORDSYNC. 2-19 

ADKP_FAST, 2-38 

ADXF.JffMPP.EC, 2-34 

ADKF_MSBSWC. 2-37 

ADKP_PRE000NS. 2-48 

ADKF_PP.B140NS. 2-49 

ADKP_PRE280NS. 2-50 

AOKF_PKSS60NS. 2-51 

ADKF_PRF,COMP0. 2-33. 2-49. 2-51 

ADKF_PREC0MP1. 2-32. 2-50. 2-51 

ADKF_SBTCUl. 2-31 

ADKF.UARTBKK, 2-35 

ADKF.USE0P1. 2-42 

ADKF.USEOVl. 2-46 

ADKF.USE1P2, 2-41 

ADKF_USE1V2. 2-45 

ADKF.USE2P3. 2-40 

ADXF_USE2V3. 2-44 
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ASKF_USE3PN. 2-39 

ADKF.USE3VN, 3-43 

AOXF.WOROSYIiC, 2-36 

AFB.50HZ. 27-107 
AFB_68010, 27-103 
AFB.68020. 27-104 
AEB_68881, 27-105 
AFBJPAL, 27-106 
ACIOError. 3-50 
AC_HakeUb. 3-46 
AC_NoMaaory. 3-45 
AC_OpanDav. 3-48 
AC.OpanLlb. 3-47 
AC_OpariP.es. 3-49 
ALEP.T_TYPS, 41-1228 
ALPHA_P_101. 41-1153 
ALTKEYMAP. 41-329 
ALTLEFT. 41-1353 
ALTRICHT. 41-1353 
AMICALEFT. 41-1354. 41-1356 
AN_BaaaChkSuB. 3-84 

ANJBltBltMap. 3-103 

AMLCspDlaplay. 3-93 

AN_CoplLiatDvar, 3-96 

AMLCopInatr. 3-94 

AN_CopLlstHaad. 3-97 

AN_CopListOver, 3-95 

ANLExcptVect. 3-83 

AN_ExecLib, 3-83 

AN_EleodFlll. 3-100 

ANLCraphlcsLlb. 3-93 

AN_InitAPtr, 3-89 

AN_IntrMsa. 3-88 

AN_Intuitlon. 3-108 

AN_LayersLlb, 3-105 

AN_LlbChkSua. 3-85 

ANJLibMsa, 3-86 

AN_LongFraae. 3-98 

AN_Me_Corrupt. 3-87 

AN.ShortFraae, 3-99 

ANL.TaxtTtopP.aa, 3-101 

AOJkudioDev, 3-63 

AO_BootStrap, 3-71 

AO_CXA]lsrc, 3-68 

AOjCListLib, 3-58 

AO.ConsolaDav. 3-63 

AOJDOSLlb. 3-59 

AOJUskHsre. 3-69 

AOJxaetlb, 3-53 

AO_CaaaPortDev, 3-64 

AO.Oraphicat.lb. 3-54 

AO_IconLib, 3-61 

AOJCntultlon, 3-56 

AOJKayboardDav. 3-6S 



AO_LaversLlb~. 3-55 
AOjkthUb, 3-57 
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AO_MiacRarc. 


3-70 




AO_RAMLib. 


3-60 




AO_TlaarDav, 


3-67 




AO_Trac)d>iakDav, 


3-66 




AO_Warkbanch. 


3-73 




AOlPan, 


34-38. 63-63 




AREAOUTLINE. 


34-38. 34-33. 63-101 




ASPECT_HORIZ, 


41-1136 




ASPECT_VERT, 


41-1137 




AT_Daad£nd, 


3-41 




AT_Racovary. 
AUTOBACXPEN. 


3-43 




41-1339 




AUTODRAVMODE. 


41-1340 




AUTOFRONTPEN. 


41-1338 




AUTOITEXTFONT. 


41-1343 




AUTOKMOB, 


41-413 




AUTOLEFTEDCE. 


41-1341 




AUTONEXTTEXT, 


41-1344 




AUTOTOPEDCE. 


41-1343 




AddFraaLiat. 


36-40 




AlartData. 


37-46 




AllocWBObjact, 


36-38 




AltXayMap. 
AraaPtSs. 


41-463 

34-31. 63-65 




AraaPtm. 


34-31. 63-56 




AttnFlaga, 


37-68 




AttnRaaehad. 


37-69 




AudChannal, 


15-86 




B, 


33-105 




BADDR. 


33-80 




BAUD_110, 


41-1105 




BAUD_1300, 


41-1107 




BAUD_19300. 


41-1111 




BAUD_3400. 


41-1108 




BAUD_300, 


41-1106 




BAUD_4800. 


41-1109 




BAUD_9600. 


41-1110 




BAUD_MIDI. 


41-1113 




BBNAME_POS. 


6-30 




BBNAMEjaCK. 


6-31 




BITSPERBYTE. 


33-30 




BITSPERLONC. 


33-33 




BLITMSG_FAULT, 


33-63 




BWDRYOFF, 


34-33 




BOOLCADCET, 


41-353 




BOTTOMBORDER. 


41-330 




BROTHER.1SXL. 


41-1154 




BYTEBITS. 


75-33 




BYTEMASK. 


75-54 




BYTESPERLONG, 


33-31 




Back? an. 


41-480. 41-509 




BitMap, 


8-39. 8-64. 8-64, 33-33. 41- 
63-55, 76-70. 76-70 


171. 41-884 


Buffar. 


41-438 




ButtarPea, 


41-440 




C, 


6-38. 6-31. 33-108 





41-884. 41-941. 41-941. 41-1010. 63-55. 
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CBD_CURRENTREADID. 9-34 

C8D_CURRENTWRITEID. 9-35 

• CBD_POST. 9-33 

CBERR_OBSOLETEID. 9-37 

CBM_MPS1000, 41-1155 

CBuap. 34-36, 34-37 

CEND. 34-38 

CHECKMIDTH, 41-1318 

CHaight, 41-405 

CIAANAME, 7-6 

CIABKAME, 7-7 

CINIT, 34-35 

CLOSE. 41-350 

CLatt. 41-448 

CMOVE. 34-36 

CMova. 34-36 

COMMWIDTH. 41-1319 

COUNT. 75-45 

CR_NEEDS_NO_CONCEALED_RASTERS. 8-74 

CTop. 41-448 

CUSTOM, 41-1149 

CUSTOMJIAME, 41-1153 

CWAIT. 34-37. 34-38 

CHalt. 34-37 

Width, 41-404 

Carg, 35-19 

ChkBaaa, 37-39 

ChkSua, 37-51 

CUpbo.rdUhiS.SS?: V-ft '^ '- 40 ' 9 - 51 ' 8 - M ' 8M 9 M 8 -"' 9 » -" 

Clock. 37-107, 31-313 

Clrlna, 76-36 

ColdCaptura, 37-40 

ColorTabla. 76-35 

CoolCaptura, 37-41 

Cuatoa. 15-30 

deadend_alert, 41-1330 

devtces_cupboard_h. 9-1, 9-3 

devicbs_:nput_h, 37-1. 37-3 

devices_pr:«»ter_h. 61-1, 01-3 

DBWCES_TIMERJI, 38-13. 41-49. 63-37. 73-15, 73-16. 73-43 

DHalght. 76-38 

DIAB_630, 41-1156 

DIABJWVJDJS. 41-1157 

DIAB_C_150. 41-1158 

DLT_P£VICB. 33-319 

DLTJHRBCTORY, 33-330 

DLT.VOLUKE, 33-331 

DMABJWD0, 31-36 

DMABJU1D1, 31-39 

DMABJU1D3. 31-40 

DMAB_AUD3, 31-41 

0MAS_BLITHOC. 31-48 

DMABJLITTER. 31-44 

DMABJLTDONE, 31-49 

MAB_BLTNZERO, 31-50 
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DMAB_COPPER, 

DMABJHSE. 

DMAB_MASTER. 

DMAB_RASTER, 

DMAB_SETOJR, 

DMAB_SPRITE. 

DMAFJUi. 

DMAF_BUTHOC, 

DMAFJLITTER. 

DMAr_BLTDONR, 

DMAFJLTNZERO. 

DMU_COFPER. 

DMAFJHSK. 

DMAF_HA3TER. 

DMAF_RASTER. 

DMAF_SPRITE. 

DOmiN. 

DOSNAMZ. 

DOUBLE. 

DRAFT. 

DUALPF. 

DWldth. 

DamagaLlat. 

DataStaap. 

DabugData. 

DabugEntry, 

DlapCount, 

DlapPoa. 

DravModa, 

Daplna, 

DxOtCaat. 

EIOHT_LPI , 

ELITE. 

ENDSADCET. 

EP80N. 

EPSON_JX_80. 

ERRC&_NO_FREE_STORE . 

ETDJXEAR, 

ETD_FQRMAT. 

ETD_MOTOR, 

ETOJtEAD. 

ETD_SEEK. 

BTO.UPDATE. 

ETD_V*ITE. 

EXCLUSIVf_LOaC. 

EXECNAME. 

EXEC_ALERTS_H. 

EXEC_EXECBASE_H. 

EXEC_LISTS_H. 

EXEC_MEMOR¥_H. 
EXEC_NODES_K, 



EXEC_PORTS_H. 



34-20. 
34-33, 



34-31 
34-33 



33-59. 33-165. 33-311 



31-43 

31-43 

31-47 
31-43 
31-37 
31-43 

31-30 
31-39 
31-33 
31-34 

31-33 
21-23 

31-33 

31-38 

21-27, 

21-24. 

53-47 

22-13 

75-44 

41-1124 

76-57 

76-38 

8-49 

33-43. 

37-47 

37-46 

9-39. 17-38. 43-34. 43-33, 61-135, 61-139 

27-61, 41-447 

41-442 

41-481, 41-510, 63-64 

76-34 

76-39, 76-50 

41-1129 

41-1120 

41-300 

41-1159 

41-1160 

22-111 

73-101 

73-99 

73-97 

73-96 

73-98 

73-100 

73-93 

33-39 

38-3 

3-1, 3-3, 3-193 

37-1, 37-3 

18-27, 19-16, 27-17, 27-19, 33-4, 40-31, 40-33, 47-12, 
59-23, 61-33, 62-18, 70-21, 70-23. 77-33, 77-24 



9-16 

50-2, 

54-1, 

9-13, 

57-1, 

77-30 

8-7, 9-19, 



18-35. 
59-21. 
54-2 

19-13. 



35-8, 



57-2, 59-17. 



40-17, 
59-19, 



40-19. 
61-19, 



48-17, 48-19, 50-17, 50-19, 
62-15. 65-17, 65-19. 70-17, 



54-17, 
70-19. 



50-1. «■ 



54-19. 

77-18, 



12-11, 17-21, 17-23, 18-39. 18-31, 33-16. 41-45, 43-17. 43-19. 
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EXEC_RESIDENT_H, 

EXTJUUiALFBRITE. 

Elapaad. 

ExacBaaa. 

ExacBaaaRaaarvad, 

ExacMaeaaga, 

FALSE, 

FANFOLD. 

FIBBJ3ELETH. 

FIBBJSXECUTE, 

FIBBJtEAD, 

FIBB_WtITE. 

FIBFJELBTE, 

FIBF_EXECUTE, 

FIBFJtEAD. 

FIBF.MRITE, 

FINE. 

EOLLOWMOOSE. 

FOREVER. 

FPENAM. 

FPEOVt. 

FPEUND, 

FPEZDV. 

FPHALF. 

FPONE. 

FPTEN, 

FPZERO, 

FREEHORIZ, 

FREEVERT. 

FRSTJDOT, 

F_ P0PFD , 

F_CETFO. 

FilalntoBlock. 

FllaLock, 

Flags. 



FraaFraaLlat. 

FraaWBOblaet. 
FrontPan, 

OADCDXSABLED. 
GADCET0003, 
QAOCETTYPE. 



CAOCHCOMP. 

SASCHI0HBIT8. 

CADCHIMACS, 

CADCHNONE, 

GADOIMACB, 

QADCIM4EDIATE. 

GENLOC, 

CENLOCKJUJDIO. 

OENLOCK_VIDEO, 

CLOBAL, 

CRAPHICS_CLIP_H. 



47-8, 59-1, 59-3, 61-27, 62-21, 68-13, 68-15, 71-13 

65-1, 65-3 

76-65 

27-63 

37-34, 37-99 

27-96 

41-583 

73-51 

41-1115 

32-69, 22-73 

33-68, 22-72 

23-66. 23-70 

22-67, 22-71 

22-73 

33-73 

33-70 

33-71 

41-1121 

41-311 

41-1210 

52-62 

32-60 

52-59 

32-31 

53-20 

53-19 

53-18 

53-31 

41-414 

41-415 

34-29, 63-94 

39-33 

39-34 

32-30 

33-325 

8-38, 8-69, 31-95. 31-148. 31-176, 31-254, 33-37, 33-47, 34-28, 34-39, 34-33, 

41-66. 41-94. 41-156. 41-304. 41-370. 41-705, 41-836. 41-937. 47-33. 63-41. 63-68. 

76-33 

36-40 

36-40 

41-480. 41-509 

41-282 

41-353 

41-337 

41-331 

41-330 

41-249 

41-252 

41-233 

41-338 

41-393 

33-60 

76-63 

76-64 

73-18 

8-1, 8-3. 41-35 
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CRAPHICS_CFXMM208_H. 

stAPHics_arx_H. 
catAPHics_a)AFmtiT_H. 

CRAPHICS_RASTPORT_H. 

(SAPHICSJIECIONSJC, 

GRELBOTTOM. 

OtELHEICHT. 

CRELRICHT, 

GRELWIDTH. 

GZZGADCET, 

Catlcon, 

OatWBObJact. 

HAM. 

HARDNARE_ADKBITS_H. 

HARDWARE_CUSTOHJI, 

HIRES. 

HP_LA3ERJET. 

KP_LASER JET_PLUS . 

HFotRaa. 

KOBE. 

HorlxBody, 

HoritPot. 

ICONNAME. 

IDNaatCht, 

ID_DOS_DISK. 

ID_KICKSTART_DISK. 

IDJWT _REALLY_D08 , 

ID_NOJJISK_PRESENT. 

ID_UNREADABLE_PISK. 

INVALIDATED, 

ID_VALIDATINC. 

ID_WRITE_PROTECTED, 

IECLASS_ACTIVEWINDOW. 

IECLASS_CLOSEWIND0W. 

IECLASSJISKINSERTED, 

IECLASS_DISKREMOVED. 

IECLAS8_EVENI, 

IECLA88_GADCETD0WN. 

lECLASS.GADCETUP. 

IECLA83_INACTIVEWIND0W. 

lICLASS_KENULIST. 

IECLAS8_NEWREFS. 

IECLASS_NUIX. 

IECLASSPOINTERPOS . 

lECUSSJtAMGEY. 

IECLASSJRAWMOUSE, 

IECLASSJJEFRESHWINDOW. 

IECLASSJE0UE8TER. 

I ECLASS_SI ZEWI NDOW, 

IECIASS_TIMER. 

IECODE_KEY_CODE_FIRST, 

IECODE_UP_PREFI X, 

IMACEJJECATIVE. 

IMACE_POSITIVE. 

IMPORT. 

INDJKDDHANDLER. 



34-1. 34-3 

8-4. 33-1. 33-3. 41-31. 63-4. 64-4, 76-4 

3S-1, 35-3 

34-16, 41-33. 63-1, 63-3 

64-1. 64-3 

41-365 

41-370 

41-366 

41-368 

41-340 

36-39 

36-38 

76-60 

3-11. 3-13, 3-53 

15-11, 15-13, 15-114 

76-58 

41-1164 

41-1165 

41-406 

53-75 

41-400 

41-380 

36-30 

27-65 

33-106 

32-108 

23-107 

22-104 

22-105 

22-101 

22-100 

22-99 

36-53 

38-41 

38-51 

38-49 

38-37 

38-33 

38-35 

38-55 

38-39 

38-47 

38-31 

38-39 

38-23 

38-35 

38-45 

38-37 

38-43 

38-31 

38-66 

38-65, 41-1348, 41-1250 

41-1133 

41-1133 

75-19 

37-16 
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IND_REMHANDLER, 

IND_SETMP0RT, 

INDJETMTRIC, 

IND_SBTMTYPE. 

IND_SETPERI0O. 

IND.SETTHRESH. 

IND.VSITEEVENT. 

INTF_VERTB, 

lOClipRag. 

ioerrjuorted. 

ioerr_badlencth, 

ioerk_n0ck>. 

ioerr_0penfail, 

IOExtTD. 

I09ERB_ABORT, 

I0SER8_ACTIVE, 

IOSERB_BUFRREAD. 

IOSESB.QUEUED. 

IOSERF_ABCRT. 

IOSERF_ACTIVE, 

IOSEREJUFRREAD. 

IOSERF QUEUED. 

lOSTB.OVEXRUN, 

IOSTB_READBSEAK. 

lOSTB.NROTEBREAX, 

i03tb_xoffread, 

iostbjcoffnrite. 

iostf.overrum, 

lOSTFJtEADBREAK, 

iostf.mrotebreax, 

iostfjcoffread, 

iostfjtoffxrite, 

lOSar, 

lOTArray, 

ISCRTRX, 

ISCRTRY, 

ISLESSX, 

ISLESSY, 

ITEMNUM, 

ITaxt, 

ITaxtFent, 

I_PI, 

I_PID3. 

IdlaCount, 

laaga, 

InteData, 

IntVaeter, 

IntVacta. 

IntrLiat, 

IntulMaaaaga. 

Iptr, 

Iarvatr, 

JAM2, 

KNOBHIT, 

XNOBHMIN, 

KNOBVMIN, 



37-17 

37-21 

37-33 

37-32 

37-30 

37-19 

37-18 

34-35, 34-26. 39-46 

9-37 

25-17 

25-19 

2S-18 

25-16 

73-109 

66-116 

66-118 

66-113 

66-114 

66-117 

66-119 

66-113 

66-115 

66-128 

66-124 

66-126 

66-120 

66-122 

66-129 

66-125 

66-127 

66-121 

66-123 

66-36 

66-26. 66-67 

8-79 

8-80 

8-77 

8-78 

41-1195 

41-485 

41-484 

52-72 

52-73 

27-60 

41-528 

22-85 

27-55. 40-33 

37-55 

27-84 

41-581. 41-618. 41-757 

35~16 

35-13, 35-16 

41-1240, 63-89 

41-417 

41-419 

41-420 



41-570, 41-765, 41-869. 77-56. 77-57 
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LACE, 76-59 

LEETBOROER, 41-318 

LETTER, 41-1125 

LIHRARIES_DOS_H, 33-1. 21-2. 33-159. 33-33. 68-17, 68-19 

LIBRAHIES_ICOM_H, 36-2, 36-3, 36-44 

LIBRARIES_HATHEEP_H, 53-1. 53-3. 53-46 

LIBRARI£S_rRANSLATOR_H. 74-1, 74-2. 74-15 

LIBRABX.VERSION. 75-56 

LOECprLlaC. 76-48 

LOO10, 53-16 

LOCHUOE. 53-77 

LOGTINY. 53-78 

LONCBITS. 75-27 

LONGINT, 41-327 

LOMOBCKWIDTH, 41-1220 

LOWC0M4WIDTH. 41-1221 

LaatAlart. 27-94 

Layar, 8-25. 8-27, 8-63, 41-161. 41-449. 41-790, 41-958. 47-34. 47-35, 47-36. 63-54. 

Layarlnto. 8-53. 41-943 

LayarLeckCount, 8-35 

LayarLeckar, 8-53 

LayarPtr. 41-449 

Layar_Info. 8-53, 41-942, 47-22 

LaftBordar, 41-407 

LibLlat. 27-85 

LibNoda. 27-35. 33-36. 43-40 

LinaPtrn, 34-39, 63-69 

Lock. 8-31, 47-29 

LockCount, 8-33 

LoekMassaga. 8-46 

LockPort, 8-45, 47-38 

Longlnt, 41-456 

LovMaaChkSuB. 37-38 

MAXBODY. 41-421 

MAXINT, 22-33 

MAXPOT, 41-422 

MENUDOMN. 41-1251 

HENUNULL. 41-1206 

MENUNUM, 41-1194 

MENUUP. 41-1250 

MINIKT. 22-34 

MODEJNEWFILE. 32-20 

M0OE_OLDFILE. 22-18 

Maak, 34-30, 63-60 

MatxhToolValua, 36-39 

MaxChara. 41-441 

MaxLoeMam, 27-45 

MaaLlae, 27-81, 54-59 

Maaory. 41-1182 -" 

MagPort, 8-45, 8-47, 13-33. 17-36. 33-33, 33-60. 23-61. 33-79, 23-309. 33-329. 41-756. 
47-27, 47-28, 59-33, 59-53, 59-60, 63-63, 63-83. 68-33 

M, 33-107 

NB*KXIPRECTS_1_1, 8-68 

NOCROSSFILL. 63-103 

NOITEM, 41-1304 
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NOMENU, 41-1303 

NOSUB, 41-1305 

NOT, 41-1313 

NTSC, 37-106, 33-59 

N.TBACT0R, 41-1147 

Haxt, 8-61, 13-53, 13-59, 13-73, 64-14, 76-31, 76-69 
NaxtBordar, 41-514 
Naxtlaaoa. 41-570 
NaxtRaaaabar, 41-1180 
NaxtTaxt. 41-486 

Noda. 9-31. 19-51, 35-15, 40-27, 40-36, 48-35, 50-33, 50-34. 50-35, 54-33, 54-60. 

~_~. 57" X !i S7 " 19 ' 57 " 20 ' S9 " 33 ' 59 " 52 ' 7 °- J7 - TJ-94. 77-95. 77-96. 77-97 

NuaChara. 41-446 

OFFSET JEGININC. 33-38 
OFFSETJECINNING, 33-34. 22-28 
OFFSET_CURRENT, 22-25 
OFFSET_END, 22-26 
0FFJ3ISPLAY, 34-21 
OFF_SPRITE. 34-33 
OFF_VBLANK, 34-26 
OKIMATE.20, 41-1161 
ONJDISPLAY, 34-20 
0N.9PRITE, 34-33 
ON.VBLANK, 34-25 
OVERFLOW, 52-49 
OPPEND, 29-11 
O.CREAT, 29-12 
0_EXCL. 29-14 
0_NDELAY. 29-10 
OJtAW, 29-16 
O.RDONLY. 29-6 
0_RDW, 29-8 
O.TRUNC. 29-13 
O.MRONLY. 29-7 

PAL. 27-106. 33-61 
PARALLEL_PRINTER. 41-1101 
PA.ICNOXE. 59-46 
PEBA. 76-56 
PI2. 53-13 
PI4, 53-14 
PICA, 41-1119 
PID4. 53-71 
PLOSS, 53-53 
POTCONAME, 60-7 
PRDJUMPRPORT, 61-33 
PRD_PRTCO>MAND, 61-33 
PRDJtAWHRITE. 61-31 
PROPBORDERLESS. 41-416 
PROPGADGET. 41-354 
PaparLanath. 41-1093 
PaparTypa. 41-1094 
PertLlat. 37-86 
Prav, 64-14 
Proplnfo, 41-368, 77-58, 77-59 
Put I con, 36-39 
PutWBObjact, 36-39 
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OUME_LP_20. 


41-1162 




Ouantua, 
RECOVERY JkLERT. 


27-62 




41-1229 




REGISTER. 


75-21 




RELVERIFY, 


41-289 




REQCADCET. 
RESOURCES_FOTCO_H, 


41-341 

60-1, 60-3 




RICHTBORDER, 


41-317 




RTC_MATCHWORD. 


65-34 




RTF_AVTOINIT. 


65-36 




RTF.COLDSTART. 


65-37 




RTKJMEN. 


65-40 




RTW_COLDSTART. 


65-42 




RT*f_NEVER, 


65-41 




Raalnfo. 


76-42, 76-42, 76-67, 76-69 




RaatPort. 


8-29, 41-718. 41-731. 41-940. 41-940, 61- 


144. 63-52 


Rat*. 


27-107 




Ractangl*. 
Ragfon, 


8-30, 8-65. 32-25. 64-15, 64-20 
8-49, 64-18 




RaglonRactangla, 


64-12, 64-14. 64-21. 64-21 




Raaanbar. 


41-1178. 41-1180 




RamaabarSlza, 


41-1181 




RaplyPort. 
RasModulaa, 


8-47 
27-70 




Raaldant. 


65-21, 65-23 




RaaourcaLiat. 


27-82 




RavdExt, 


37-49 




RxOff.at. 


76-71 




RyOffiat. 
SCS GADGET, 


76-71 




41-339 




SDCMD_BREAK, 


66-93 




SDCMD_QUERY, 


66-92 




SDCMD_SETPARAMS , 


66-94 




SDOWNBACK. 


41-349 




SDRACCINC. 


41-345 




SELECTDOWN, 


41-1249 




SELECTED. 


41-275 




SELECTUP. 


41-1248 




SERB.7WIRE. 


66-106 




SERB_EOFM0OB. 


66-98 




SERB_PARTY_ODD, 


66-108 




SERB_PARTY_ON. 


66-110 




SERB.QUEUEDBRK. 
SERB_RAD_BOOCIE. 


66-104 
66-102 




SERB_SHMtED, 


66-100 




SERB_XDI8ABLED, 
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Sprlna. 76-35 
Stringlnfo, 41-435 
SuparBitMap, 8-39 
SuparClipRact, 8-40 
SuparSavaClipRaeta, 8-54 
SyaFlaoa, 37-64 
SyaStkLovar, 37-44 
ByaStkUcpar. 37-43 
TDEBR_BadDrivaTvpa, 73-140 
TDERR_B»dHdrSuM, 73-131 
TDEJW_BadSacHdr, 73-134 
TDERR_B»dSacID, 73-130 
TDERK_BadSacPraaobla, 73-139 
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aDEN6. 61-61 
aFNTO. 61-76 
aFNTl. 61-77 
aFNTIO, 61-66 
aFHT2. 61-78 
•TOT3. 61-79 
•FNT4, 61-80 
aFNTS, 61-81 

•rare, ei-82 

aFNT7. 61-83 

•FNT8, 61-84 

•FNT9. 61-8S 

aHIS, 61-113 

alKD, 61-39 

»JFYO, 61-95 

aJFYl. 61-97 

aJFY3, 61-96 

aJEYS. 61-92 

aJFY6. 61-94 

«JF)f7, 61-93 

aLKS, 61-105 

aHEL. 61-40 

•PERE, 61-102 

aPERFO. 61-103 

aPLD. 61-74 

aPLU. 61-73 

aPROPO. 61-90 

aPROPl. 61-89 

•PROP2. 61-86 

aRI. 61-41 

»RIN. 61-38 

aRIS, 61-37 

aRMS, 61-106 

•SBC. 61-51 

aSEC. 61-50 

•SCRO, 61-43 

•SCR1, 61-48 

aSCR22. 61-49 

•SCR23. 61-45 

•SGR24. 61-47 

aSCR3. 61-44 

aSGR4. 61-46 

•SHORPO, 61-53 

aSHOBPl. 61-55 

aSHORP2. 61-54 

aSHORPS. 61-57 

aSH0RP4, 61-56 

■SHORPS. 61-59 

•SH0RP6. 61-S8 

aSLPP. 61-101 

•SLRM. 61-110 

aSTBM, 61-109 



Dae 9 13:55 196S C-Includa-Ftla-Xra« Paga 16 



•SUSO. 61-72 

•SUS1. 61-69 

•SUS2. 61-68 

aSUS3. 61-71 

•SUS4. 61-70 
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•tot, 52-92 

atol. 52-90 

atol. 52-91 
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drand48. S3-96 
daJDays, 33-43 
d»_Mlmit«, 33-44 
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flb_EntryTyp*. 33-56 
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fraxp, 53-93 
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64-5, 76-5 
i, 53-35, 53-35 
Icon. library, 36-30 
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id_NuaBlocksUs«d. 33-90 
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lo_Jt«aeXan. 66-68 

lo_S«rflag», 66-71 

lo.StopSlta, 66-70 

io.TarmArray, 66-67 

lo_(Mlt, 9-40. 43-35. 43-34. 61-136, 61-140 
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a. 34-30. 34-30 

aatharr. 53-90 
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Appendix E 
Assembly Include Files — ".i" Files 



This appendix contains the assembly language include files that define the system data struc- 
tures used by the ROM (or kickstart) routines and the disk-loadable libraries. 

As with the documentation files, these include-files are organized on a functional basis. In 
other words, things pertinent to the exec are listed under "exec/something.i", things per- 
tinent to graphics are listed under "graphics/ graphicsitem.i" and so on. 

This appendix is a hard-copy of the "SYS:includes" directory on the Amiga Macro Assembler 
disk. 
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Cro»» Rafaranca Utility (C) 1984. 1985 CoModora-Aalga. Inc. 

i : !S?H 1 ? n,ry , .. >:«bl«»-l 3:adVblt».l 4:alarta.l 5:audlo.l 
f:blit.l 7:bootbloek.l 8:ci«.i 9:ciabaaa.l 10: clip" 
}i : Sr 1 E b ? ,rd f. J . 1 . a i eon,oU1 13:coppar.l 14:cuatea.i 15:davieaa 1 
16:dl«k.l 17:diak(ont.i 18:ol»pl«yTi 19:d*ablta.l 30'doai 
U:daa_llb.l 22 :a»a*xt.na . 1 33ia?foP..l wlSac!! IsiSae lib i 
26:axacbasa.i 37 :axacn*ma . i 28:gaaaport.l 39: gal • i 30^oiS i 
S'JfiSK*"* 22 ! } conl 33:lnitiallxar..i 34:lnput.l 35 ! Znputavant i 
X'SSi*!; 1 . 37:intarmpta.l 38: intuition. i 39TintultionbilaTl « : io i 
41:kaybeard.i 42 jtaMap . i 43:layara.i 44:librarla..l 4s"liata.l 
46:aaaory.i 47:al*e.i 48:narrator.i 49:nedaa.i 50 : paraxial i 
Sl:porta.i 52:potge.i 53:prlntar.l S4:prtfaasa.i SsTra.tportTi 
M:raglona.i 5*7raaloant.i ' 58:sarlal.l *59 : .prlta . i eo'atartup i 
61:atrlnga.l 62:taaka.i 63:taxt.i M:tlaar.l 65:traetodiak:i P 
66:traneIator.i 67:typaa.l 68:vi*v.i 69: workbench. 1 r ™ a """ KX 

ABC, 6-38 
ABNC, 6-39 

ABORT. 50-75. 58-73 
ABCRTIO, 40-81 
ACTIVATE. 38-807 

„ ACTIVE, 15-51. 16-73. 50-76. 58-73 

ADALLOCJDUCPREC. S-19 

ADALLOC_MINPREC. 5-18 

ADOCBJIOUMIT. 5-37 

ADCMDF_NOUNIT. 5-38. 5-39 

ADCMD_ALLOCATE. 5-39 

ADOO>_FINISH. 5-33 

AOCK>_FREE, 5-31 

ADOO_LOCK. 5-35 

ADCMD_PERVOL, 5-34 

ADCMD_SETPREC, 5-33 

ADCfO.WAITCYCLE. 5-36 

ADDQ.B, 3-40, 3-45. 3-80 

ADHARO_CHANNfiLS, 5-16 

ADI0B_N0W«T. 5-35 

ADI08_PERVOL. 5-31 

ADIOB_SWCCYCLE. 5-33 

ADIOB_WRITEMESSACE. 5-37 

ADIOERRJUXOCFAILED. 5-41 

ADIOERK_CKANNELSTOLEN. 5-43 

ADIOERK_NOALLOCATia». 5-40 

ADIOFJWWUT. 5-36 

ADIOFJPERVOL. 5-33 

ADIOF_SYNCCYCLE. 5-34 

ADIOF.WRITEMESSACE. 5-38 

ADXB.FAST. 3-32 

ADKB_MFMPREC. 3-18 

ADKBJttBSYNC. 3-31 

ADKB_PRECOMP0. 3-17 

ADKB_PREC0MP1. 3-16 

ADKB_SETCLR. 3-15 

ADKB.UARTBRK. 3-19 

ADKB_USE0P1. 3-36 
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ADKB.USEOVl. 3-30 

ADKB_USE1P2. 3-35 

AOKB_USElV3. 3-39 

ADKB_USE2P3, 3-34 

ADKB.USE2V3. 3-28 

ADKB.USE3PN. 3-33 

ADKB.USE3VN. 3-37 

ADKB.WORDSWC. 3-30 

ADKF_FAST. 3-39 

ADKF_MFMPREC, 3-35 

ADKEJBBSYNC, 3-38 

ADKF_PRE000MS, 3-49 

ADXF_PRE140NS, 3-50 

ADXF_PRE380NS, 3-51 

ADKF_PRE560NS. 3-53 

ADKE_PREC0MP0. 3-34. 3-50, 3-53 

ADKF_PREC0MP1. 3-33. 3-51, 3-53 

ADKE_SETCLR. 3-33 

ADKF.UARTBRK. 3-36 

ADKF.USE0P1, 3-43 

ADXF.USE0V1. 3-47 

ADKF_USE1P3. 3-43 

ADKE.USE1V3, 3-46 

ADKF_USB3P3. 3-41 

ADXF_U8E2V3. 3-45 

ADKE.USE3PN, 3-40 

ADXF_USE3VN, 3-44 

APXF.MOBDSYNC. 3-37 

AE. 17-60, 17-61, 17-63 

AG_IOError, 4-71 

AC_MakaLlb. 4-67 

AC_NeMamery, 4-66 

AC.OpanDav, 4-69 

AC_OpanLib, 4-68 

AC.OpanRaa, 4-70 

ALERT. 4-39 

ALERTMAOC. 4-17 

ALLOC0, 16-68 

ALLOC1, 16-69 

ALLOC2. 16-70 

ALLOC3. 16-71 

AI.TXEYMAP. 38-339 

ANBC. 6-40 

ANBNC. 6-41 

AN_Boetlrror, 4-212 

AN_BootStrap, 4-211 

AN.dARarc. 4-200 

AN_DRHaaOiak. 4-204 

ANJJRIntNoAct. 4-205 

ANJDialdtare. 4-203 

AN_MlscRare, 4-208 

ANJIMBadRaq. 4-197 

ANjriaarDav. 4-196 

AN.WorWsanch. 4-215 

AREAOUTLINE, 55-46 

AX_PaadEnd, 4-62 
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AIjMWtiY, 4-63 
AUDIONAME. S-12 
AUTOITEXTEONT. 38-1359 
AUTONEXITEXT. 38-1360 
AbortlO. 25-80 
AddSavica. 35-73 
AddLibrarv. 35-66 
AddPort, 35-59 
AddRaaourca, 35-81 
AlartData. 36-45 
AllocTrap. 25-57 
Araalnfo. 55-93 
AttnFlaga, 36-83 
AttnRaachad, 36-84 
BACKDROP, 38-799 
BEGINIO. 40-77 
BCE.S. 2-53. 2-60 
SOLO. 63-21 
BORDERLESS. 38-805 
BOTTOMBORDER. 38-330 
CD_ASKKEWAP. 12-36 
CD_SETKEYMAP. 13-37 
CHECKED. 38-143 
CHECKIT. 3B-128 
CLEANME, 6-26 
CLEANMEn, 6-25. 6-36 

OS), 33-48. 33-50. 33-54 
O0_CLEAR, 40-117, 65-98 

CMD COUNT. 40-95. 40-98. 40-103, 40-104, 40-104 
ODJIMSH, 40-120 
CMD.INVALID. 40-112 
OOJWNSTD. 5-21, 5-22, 5-23, 5-24, S-2S, 5-26. 40-95, 40-125, 50-48, 50-49, 58-42. 
58-43. 58-44. 58-46 
CTOJREAD, 40-114. 65-93 
OE_RESET. 40-113 
OCJJTART. 40-119 
OO_ST0P. 40-11B 
OB>_UPDATE, 40-116. 65-97 
CMD_WRITE. 40-115. 65-92 
COMMSEQ, 38-130 
COPPERJWVt. 13-9 
COPPEK.MAIT. 13-10 

COUNT. 33-43. 33-46, 33-48 
CPRNXT8UF. 13-11 
CPR_NT_L0F, 13-13 
CPR_NT_SHT. 13-13 
CTC_tfCLRTAB. 12-86 
CTC_HCLRTABSALL. 13-87 
CTC_HSETTAB. 12-65 
CTRL_C. 20-150 
CTRL_D, 20-151 
CTRL_E. 20-152 
CTRL_E, 20-153 
ChacklO. 25-78 
ChkBaaa. 26-36 
OikSua. 26-48 
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CIom, 21-19 
CloaaDavica. 2S-7S 
CloaaLlbrary. 25-69 
ColdCaptura. 26-37 
CoolCaptura, 36-38 
Coplna. 13-15 
Coptlat. 13-33 
CraataOlr, 21-33 
CraataProc, 21-36 
CurrantDlr, 31-34 
DBUFFER. 55-44 
DO. 15-32 
DD.SIZE. 15-33 
DEFERREFRESH. 38-310 
DESICNED. 63-31 
DEVICES_AUDIO_I, 5-1, 5-3 
DEVICES_CONSOLE_I, 13-1. 13-3 
DEVICES_INPUTEVENT_I. 35-1, 35-3. 38-51 
DEVICES_INPUT_I, 34-1. 34-3 
DEVICES_KEYBOARD_I. 41-1, 41-3 
DEVICES_KEYMAP_I, 43-1, 43-3 
DEVICES_PARALLEL_I, 50-17, 50-18. 50-136. 54-30 
DEVICES_PRINTDl_I. 53-1, 53-2 

DEVICES_TIMER_I. 35-13, 38-47, 54-36, 64-15, 64-16 
DEVXCES_TRACKDISK_I. 65-18. 65-19 
DEVJkBCRTIO. 40-68. 40-83 
DEV_BECINIO. 40-67, 40-78 
DFH_ID, 17-40 
DISABLE, 3-37 
DISOtESOURCE, 16-55 
DISatESOURCEUNIT. 16-47 
DISK. 17-61 
DISKFONT. 63-36 
DISKJUME, 16-100 

DR, 16-68, 16-69, 16-70. 16-71, 16-73 
DRT.37422D23. 16-133 
DRT_AMICA. 16-131 
DRT_EMPTY. 16-133 
DRU.DISCBLOCK. 16-48 
DRUJ3ISCSYNC, 16-49 
DRU_INDEX. 16-50 
DRU.SIZE. 16-51 
DRJkLLOCUNIT. 16-106 
DR_CIARESOURCE, 16-60 
DR_CURRENT, 16-56 
DR_DISCBLOCK, 16-63 
DRJJISCSYNC. 16-64 
DR_FLACS, 16-57 
DR_FREEUNIT, 16-107 
DR.CETUNIT. 16-108 
DR_CETUNIT1D, 16-110 
DR_CIVEUNIT. 16-109, 16-113 

DR.INDEX, 16-65 
DK_LASTCOM4. 16-113 
DR.SIZE. 16-66 
DR_SYSLIB, 16-59 
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DR_UNITID. 16-61 

DR_KAITINC. 16-62 

DRnad, 16-58 

D3.W. 16-103, 33-41, 52-10, 64-28, 65-71 

DSKDMAOFF. 16-82 

D8R_CPR. 13-82 

DabugData. 26-44 

DabugEntry, 26-43 

Dalay, 21-46 

DalataFlla, 21-25 

DavlcaLiat. 26-98 

DavlcaFroc. 21-42 

DiakFontHaadar, 17-43 

DiapCount. 26-76 

DoIO, 25-76 

DoaPackat. 22-76 

DupLock, 21-29 

ENABLE. 2-50, 2-53, 2-55, 2-60, 2-62 

ENQGADCET, 38-312 

EOFHODE, 50-73, 58-64 

ETDJXEAR. 65-98 

ETD_FORMAT. 65-96 

ETDJWTOR. 65-94 

ETDJREAD, 65-93 

ETD_SEEK, 65-95 

ETD.UPDAXE, 65-97 

ETD_V«ITE. 65-92 

EXEC_ABLES_I , 2-1, 2-2, 2-88 

EXEOLERTS.I. 4-1, 4-2, 4-217 

EXEC_DEV1CES_I, 15-1, 15-2, 15-54 

EXEC_EXECBASE_I. 2-21, 2-23, 36-1, 26-2, 26-120 

EXEC_INITIALIZERS_I. 33-1, 33-21 33-59 

EXEC_INTERRUPTS_I. 16-32, 16-34, 26-21, 26-23, 31-15, 37-1, 37-2, 37-71 

EXEC_I0_I. 5-8, 11-32, 12-19, 28-13, 34-13, 40-1, 40-3, 40-137. 41-13 48-8 SO-M 

-«— »,. !|;|5:J^S:|!:J!:!S-&5S L a:U : S:8 : tn. „.". ^"l,,. 

EXEC_STRINCS_I. 50-20, 50-33, 58-20,- 58-22. 61-i. 61-2 61-64 

EXEC_TASKS_I. 32-14, 54-26! 62-1, 62-2, 62-92, 69-26 69-28 

EXEC_T»ES_I, ^"i.'-JI:^*"!*:-,"-". "-"- 4'-*. 47-7, 60-14, 60-16, 67-1, 67-3, 

EXTCOM. 65-74 ' 

EXTENDED, 63-19 

Elapaad, 26-78 

ExNaxfc, 31-31 

Exaalna, 31-30 

ExaeBaaa, 36-33 

ExaeBaaaRaaarvad, 36-109 

Exacuta, 31-50 

Exit, 31-37 

EC, 17-35 

ECH, 17-34 

FCH_ID, 17-33 

FOLLOVMOUSE. 38-333 

FORBID, 3-79 

FP, 63-35, 63-36, 63-37, 63-38, 63-39, 63-30, 63-31, 63-33 
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FRSTJJOT, 55-43, 55-107 

FS, 63-19, 63-30, 63-31, 63-33 

FS_JK*MAL, 63-18 

FllaHandla, 33-59 

FindPort. 35-65 

FraaTrap, 35-58 

CADCDISABLED, 38-396 

GADCETTYPE. 38-346 

CADCKBOX, 38-369 

GADGHCOKP, 38-368 

GADCHXCHBITS, 38-367 

GADGKIMAGE, 38-370 

CADGHNONE. 38-371 

GADCIMACE, 38-375 

GADQimEDIATE, 38-307 

GIMMEZEROZERO. 38-803 

GRAPHICS_COPPER_I. 13-3, 13-3 

GRAPHICS_GFXBASE_I, 31-6, 31-7 

CRAPHICS_TEXT_I, 17-19, 38-39, 63-1, 63-3 

CRELBOTTOM, 38-281 

CRELHEIGHT. 38-286 

CRELRICHT, 38-282 

GRELHIDTH. 38-284 

Cadgat, 38-219 

Galalnfo, 55-22 

GatCC, 25-88 

CatMag, 25-62 

CatPaekaC, 21-40 

CexBaaa, 31-19 

HARDWARE^ADKBITS.I. 3-12, 3-13, 3-54 

KARDWARE_BLIT_I. 6-11, 6-13, 6-89 

HICHBOX. 38-138 

HIGHCOMP. 38-137 

H1CHELAGS, 38-135 

HICHIMACE, 38-136 

HIGHITEM. 38-147 

HICHNONE, 38-139 

HSIZEBITS. 6-39. 6-30 

HSIZEMASK. 6-31 

ICONNAME. 33-30 

IDNaatCnt. 3-40. 3-45. 3-53. 3-59. 36-80 

lECLASS^ACTIVEWINDOW. 35-53 

IECLASS_CLOSEWINDOW. 35-41 

IECLASS_DISKINSERTED, 35-51 

IECLASSJ5ISKREMOVED, 35-49 

IECLASS_EVENT, 35-37 

IECLASS.GADCETDOMN, 35-33 

IECLASS.GADCETUP, 35-35 



IECLASS_MENULIST, 35-39 

IECLASS_NEWREFS, 35-47 

IECLASSJWLL. 35-31 

IECLASSJPOINTERPOS. 35-39 

IECLASSJMMKEY, 35-33 

ZECLAS8_RAVMOUSE. 35-35 

lECLASSJREFRESHWINDOW, 35-45 

lECLASSJtEQUESTES, 35-37 
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IECLASS_SIZEWINDOW. 36-43 

IECLAS9_TIMER. 35-31 

IND_ADDHANDLER, 34-19 

INDJIEMKANDLER. 34-30 

IND_SETMPCRT, 34-34 

IND_SETMTRIC. 34-26 

IND_SETMTYPE, 34-35 

IND_SETPERIOD, 34-23 

IND_SETTHRESH. 34-22 

IND_KRITEEVENT. 34-21 

INITBKTE. 33-18 

INITLONC. 33-33 

INITSTRUCT. 33-40 

INITWORD. 33-26 

INREQUEST. 38-811 

INTASK. 15-53 

INTUITION_INTUITIONBASE_I. 39-1. 39-2 

INT_ABLES, 2-32 

10, 40-34. 40-56. 54-62. 54-63. 54-64. 54-65 

lOAudio. 5-44 

IOEXTPAR. 50-95 

IOEXTP»r_SIZE, 50-123. 54-89. 54-90. 54-91. 54-94 

lOEXTTD. 65-105 

IOPAK. 50-74, 50-75, 50-76 

IOPT, 50-77, 50-78, 50-79, 50-80 

IOSTD_SIZE. 40-51. 48-58. 50-95. 58-91. 65-105 

IOTD_COUNT. 65-106 

IOTD.SECLABEL. 6S-107 

lOTD.SIZE. 65-108 

IOTV_TIME. 64-37 

IO_ACTUAL. 40-45 

IO_CO»MAND, 40-37 

IOJDATA. 40-47 

IOJDEVICE. 40-35. 40-78. 40-82 

IO_ERR0R. 40-39 

IO_FLACS. 40-38 

IO_LENCIH. 40-46 

IO.OFFSET. 40-48 

I0_PARELAC8. 50-121 

IO_PARSTAXUS. 50-120 

IO_PEXTFLAGS, 50-119 

IO_PTERMARRA*. SO-122 

IO_SIZE. 5-44. 40-40. 53-129. 53-137. 64-36 

IO.UNIT. 40-36 

ISDRAMN. 38-146 

ITALIC, 63-30 

ITEMENABLED, 38-132 

ITEMIEXT. 38-129 

IVAUD0. 26-61 

IVAUD1. 26-62 

IVAUD2. 26-63 

IVAUD3. 26-64 

IVBLIT. 26-60 

IVCOPER. 26-58 

IVDSKBLK. 26-55 

IVDSKSYNC, 26-66 
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IVEXTER. 26-67 

IVINTEN. 26-68 

IVNMI. 26-69 

IVP0KTS. 26-57 

IVRBF. 26-65 

IVSOFTINT. 26-56 

IVTBE. 26-54 

IWERTB. 26-59 

IdlaCeunt. 26-75 

Info. 21-32 

Input. 21-22 

InCVacta. 26-53 

InerLlat, 26-99 

IntuitlonBase. 39-37 

IoErr. 21-35 

Islntaraetiva. 21-49 

JSR. 2-85, 44-109 

KBD.JU3DRESETKANDLEH, 41-21 

KBD_READEVENT. 41-19 

KBDJtEADMATRIX. 41-20 

KBDJtEMRESETHANDLER, 41-22 

KBD_RESETHANDLERDONE. 41-23 

KCB_CONTROL. 42-32 

KCB.DOMNUP. 42-34 

KCB_NOP. 42-25 

XCB_STRINC. 42-37 

KCFJU.T. 42-31 

KCF.CONTROL. 42-33 

XCE_DOWNUP. 42-35 

KCF_NOP. 42-26 

KCF_SHIET, 42-30 

KCE_STRINC. 42-38 

KC_NOQUAL. 42-28 

KC_VANILLA. 42-29 

KayMap. 42-13 

LEFTBORDER. 38-328 

LIBINIT. 16-105. 40-65. 44-38, 44-62. 47-48 

LIBRARIES _DISKFONT_I, 17-1, 17-2 

LIBRARIES_DOSE]CTENS_I, 22-1. 22-3. 22-234. 54-39 

LIB_BASE. 16-105. 44-26. 44-27. 44-62. 47-48 

LINKLIB. 40-78. 40-82, 44-115, 44-117 

LMN_RECION. 43-23 

LN. 49-24 

LN_NAME. 49-29 

LN_PRI. 49-28. 54-59 

LN.SUCC. 49-25 

LN_TYPE, 49-27 

LONCINT, 38-337 

LastAlart, 26-107 

Layarlnfo.axera, 43-16 

Layar_In(o. 43-32 

LlbLlat. 26-100 

LoadSag. 21-38 

Lock. 21-27 

LovMaaChkSua. 26-35 

MACRO. 2-32. 2-37. 2-50. 2-73, 2-79, 2-84. 5-12. 8-6. 8-10. 13-95. 12-98, 
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16-100. 30-15. 30-81.. 30-94. 31-11. 39-49, 39-54, 33-30 33-18 33- j« ,, „ 
33-40, 40-77, 40-81, 40-93, 40-103, 44-38, 44-S0 44-105 44-107 "i2!il J 3 "22' , „ 
45-37, 45-44, 45-53, 45-57, 45-61, 45-66, 45-71, 45-76, 45-83 45-90 it' i22" U7 ' 
45-107. _4S : 136._45 : 133, 47-53, 50-67, 53-7. 58-59. 61-35 . 61'ij 61?S0 61?S7 
67-31, 67-36, 67-31, 67-36, 67-41. 67-46? 67-51 67-56 
67-76, 67-81, 67-86, 67-91, 67-107. 67-lis ' 





64-36, 


65-69, 67-17, 




67-61, 


67-66. 67-71, 


MAXBYTESPEBROW, 


6-34 




MAXCYL3, 


65-33 




MMCFONTNAME. 


17-41. 


17-55 


MAXFONTPATH. 


17-33, 


17-36 


MAXRETRY. 


65-37 




MEMORY, 


17-60 




HENUSTATE, 


38-813 




MENUTOGCLE, 


38-131 




MENUTOGGLED, 


38-148 




MEXIT, 


33-53 




MM, 


51-63 




MN_LENGTH. 


51-65 




KH_REPLYPORT, 


51-64 




MP, 


51-33 




KP_FLACS, 


51-33 




MPJOCLIST. 


51-36 




MP_SICBIT. 


51-34 




MP_SICTASK. 


51-35, 


51-43, 51-83 


MP_SOFTIHT. 


51-43 




MRB_8IZE. 


48-80 




M-ASM. 


13-95 




K..AWM. 


13-98 




M_L»1, 


13-94 




MaxLocMea, 


36-42 




MoLlst. 


36-96 




NABC. 


6-43 




NOCAREREFRESH. 


38-816 




NOOtoSSFILL, 


55-47 




NT_PEV1CE, 


49-38 




mjcm. 


49-47 




NT_FREEMSC. 


49-41 




NT.IWTERRUPI, 


49-37 




NT_LIBRARY, 


49-44 




NT_MEM0RY, 


49-45 




NT_MES8ACE. 


49-40 




NT_MSGP0RT. 


49-39 




NT_PROCES8. 


49-48 




NTJtEPLYMSG. 


49-43 




NI_RESOORCE. 


49-43 




NT.SEMAPHORE. 


49-49 




NT_SOFTINT. 


49-46 




NT_tASK. 


49-36 




NT_UMKNOWN. 


49-35 




NUMCYLS. 


65-32, 


65-33 


NUMHEADS. 


65-36 




NUMSEC3. 


65-35 




NUMTRACKS, 


65-38 




NUMUNITS, 


65-39 




NavWlndov. 


38-841 




ONE_DOT, 


55-43, 


5S-10S 
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OTHERJE FRES H. 38-797 

OWNBLITTERn. 31-55 

OldOpanLlbrary. 35-68 

Opan, 31-18 

OpanDavica. 35-74 

OpenLibrary, 3S-93 

OpcnRaaouree, 25-83 

Output, 21-23 

PAPEROUT. 50-79 

PAR, 50-71, 50-73, 50-73 

PARALLELNAMZ, 50-67 

PA.ICNORE, 51-54 

PASSIONAL. 51-52 

PA_SOETINT, 51-53 

PBUSY. 50-78 

PDCMD.QUERY. 50-48 

PDCMD.SETP ARAMS, 50-49 

PERMIT, 3-84 

PF_ACTION, 51-47 

POINTREL, 38-303 

POTCONAME, 52-7 

PRDJXJMPRPORT, 53-39 

PRD_PRTCOMMAND. 53-38 

PRD.RAWWRITE, 53-37 

PREOXAWN, 38-304 

PR1MARY_CXIP, 11-57 

PROPORTIONAL, 63-30 

PSEL, 50-80 

PTERMARRAY, 50-85 

PTERMARRAY_0, 50-86 

PTERMARRAY_1, 50-87 

PTERMARRAY_SIZE, 50-88, 50-122 

ParErr_Bu(TooBlg, 50-35 

ParErrJDavBuay, 50-34 

ParErr_InltErr, 50-40 

ParErr.InvParaa, 50-36 

ParErr_LinaErr, 50-37 

ParErr_NetOpan, 50-38 

ParErrJPertRaaat, 50-39 

Par_PEVFINISH. 50-50 

ParantOlr. 31-48 

PortLlat, 36-101 

PrlntarExtandadData, 54-121 

PrlntarSagaant. 54-143 

Proeaaa. 33-33 

Proeura. 35-90 

PutMeg, 35-61 

QBOWNEX. 31-58 

QBOWNERn, 31-56, 31-58 

QUEUED, 50-74, 54-63, 58-71 

QUICK. 40-56 

Quantum, 26-77 

QuauaPaekat, 21-41 

RAD_BOOCIE, 50-72, 58-66 

REFRESHBITS, 38-793 

RELVERIFY. 38-302 
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REMOVED. 63-33 
REP0RTM0U8E. 38-801 
REQACTIVE. 38-208 
REQOFFWXNDOW. 38-207 
RESOURCES_DISK_I. 16-1. 16-2 
RESOURCES JOTOO_I, 52-1, 52-2 
RETUMCFAIL, 20-147 

REVPATH. 63-27 
RICHTBORDER. 38-327 
RMBTKAP. 38-815 
ROMFONT. 63-25 

RP. 55-42. 55-43, 55-44. 55-46, 55-47, 55-56 

RP_COMPLEMENT. 55-52 

RP_INVERSVID, 55-53 

RP_JAM1, 55-50 

RWDIK. 50-77 

RaatPort. 55-58 

RavOoFat. 25-87 

RavIOInlt, 25-84 

RauHayCatChar. 25-85 

RavPutChar, 25-86 

Raad, 21-20 

RasDavlea. 25-73 

RaaLlbrary. 25-67 

RamPort. 25-60 

RaaRaaourca, 25-82 

Ranaaa. 21-26 

RaplyMag. 25-63 

Raquaatar, 38-158 

RaaModulaa. 26-85 

RaaourcaList, 36-97 

RsvdExt. 26-46 

S, 4-17, 7-47. 20-114. 20-115, 37-53, 37-54, 37-55 

SELECTED, 38-290 

SGRJBLACK. 12-39 

SOt_BLACKBC, 12-49 

SCR_BLUE. 12-43 

SCR_8LUEBC. 12-53 

SOt_BOLD. 12-33 

SCR_CLR0, 12-61 

SOt_CLR0BC, 12-70 

SCR_CLR1. 12-62 

SCR_CLR1B0, 12-71 

3CR_CLR2, 12-63 

SCR_OJt2BC. 12-72 

SCS_CLR3, 12-64 

SOl_CLR3BC, 12-73 

SCR_CLR4, 12-65 

SCR_CLR4BC, 12-74 

SCK.CLRS. 12-66 

S£S_CLRSBG. 13-75 

SCR_CLR6, 12-67 

SCR_CLR6BC, 12-76 

SCR_CLR7, 12-68 

SCR_CLR7BC. 12-77 

SCR_«AN, 12-45 
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SC*_CYANBC. 12-55 

SCR_DEFAULT, 12-47 

SCBJDEFAULTBG. 12-57 

SCK_C8EEN, 12-41 

SCR.QREENBG. 12-51 

SCR_ITALIC, 12-34 

SCRJUCENTA. 12-44 

SCR_MAGENTABO, 12-54 

SCR_NEOATIVB, 12-36 

SCR_PRIMARY, 12-32 

SCRJtED. 12-40 

SCRJtEDBC, 12-50 

SCR_UNDERSCORE, 12-35 

SOt_NHITE, 12-46 

SCR.WHITEBG, 12-56 

SCK.YELLOW, 12-42 

SCR_YELLOWBC, 12-52 

SHARED. 50-71, 58-65 
SICBREAK, 20-150, 20-151, 20-152, 20-153 
SIMPLEJtEFRESH, 38-795 
SIZEBBOTTOM, 38-789 
SIZEBRICHT, 38-788 
SIZEOF_VIEW. 39-40 
SM, 51-75 
SMARTJtEFRESH, 38-794 
SM_BIDS, 51-76 
SMJ.OCXMSG. 51-82 
SM_SIZE, 51-77 
STRINC, 50-68, 58-60, 61-35 
STRINGCEMTER, 38-334 
STRINGRIGHT, 38-335 

SUBQ.B. 3-52, 2-59 
SUPER_BITMAP, 38-796 
SUPER.UNUSED, 38-833 
SYSREQUEST. 38-209 
SatiafyMag. 11-59 
Seraan, 38-909 
Saak, 21-24 
SandIO, 25-77 
SatCeaaant. 21-43 
SaCFunetlen, 25-70 
SatProtaetlon, 21-44 
Softlnta. 26-105 
SettVar, 26-34 
SuaLibrary. 25-71 
SyaFlaga, 26-79 
SyaStkLovar. 26-41 
SyaStkUppar, 26-40 
TALLDOT, 63-28 
TASKJUILE8, 2-73 
TBC_HCLRTAB, 12-90 
TBCJKXRTABSALL, 12-91 

TC_SIZE, 22-34, 54-101, 62-54 
TD, 65-74 
TDERR_BadHdrSuB, 65-124 
TDERRJadSacHdr, 65-127 
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TDERSJadSacID. 65-133 

TDERR_BadSaePraaabla, 65-133 

TDERK_BadSacSua. 65-135 

TDERR_Di»kCJiangad, 65-139 

TDESHJToSacHdr, 65-131 

TDEHUfotSpacltlad, 65-130 

TDERR_TooEavSaca. 65-136 

TDnOL.MrltaPro«. 65-131 

TOFJtXIOOH. 65-93. 65-93, 65-94, 65-95, 65-96, 65-97, 65-98 

TONMCCht, 3-80, 36-81 

ID.CKANCENUM. 65-91 

ID.CHANCESTATE. 65-83 

TD_FCNttX. 65-79, 65-96 

TDLABELSIZH. 65-113 

TftJJWTCCttf, 65-65 

TDJiOTOR, 65-77, 65-94 

TDJWW, 65-69 

TD_PR0TSTATU8, 65-83, 65-85 

TD_REM0VE, 65-80 

TD.SECSHIFT, 65-50 

TO_SECTCR. 65-49 

TD_SEEK. 65-78, 65-95 

TIMEREQUEST, 64-36 

TIMEKNAME. 64-36 

TIMEVAL. 64-31 

TOOCLESELECT, 38-333 

TOPBORDER. 38-339 

TR^WDREQUEST. 64-43 

TR_CETSYSTIME, 64-43 

TR_SETSYSTIME, 64-44 

TV_MICR0, 64-33 

TV_SECSi 64-33 

TXSCALE, 55-56 

TaakExeaptCoda. 26-68 

TaakExltCod*. 36-89 

Taaldtaady. 36-103 

Taalc91aAllee, 36-90 

TaakTrapUloc, 36-91 

TaakTrapCoda. 36-87 

TaakMalt, 36-103 

TaxtAttr. 63-36 

TaxtFont, 63-45 

ThlaTaak. 36-74 

TapRaa, 55-15 

TypaOfMaa. 35-89 

UCopLiat, 13-46 

UNDERLINED, 63-33 

UNIT, 15-43, 15-51. 15-53 

UNIT_EIACS. 15-43 

UNIT_MiatOHZ, 64-33 

UNIT_OPENCKT, 15-45 

UNIT_SIZE, 15-46 

UNIT_VBLANK, 64-34 

UNIT_pad, 15-44 

UnLoadSaa, 31-39 

UnLock. 31-38 
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VSIZEBITS. 6-30 
VSIZEMASK. 6-33 
Vaeata. 35-91 
VlavPort. 13-36, 68-38 
WBENCHWIKDOW. 38-830 

WIDEDOT, 63-39 
HINDOVHCTIVE, 38-810 
WIKD0WCL08E. 38-786 
WINDOMDEPTH. 38-785 
WINDOMDXAC. 38-784 
WINDOWEFRESH. 38-819 
WIND0N8IZINC. 38-783 
VflNDOWTICXED. 38-831 
W0RKBENOI_IC0H_I. 33-3. 33-3. 33-34 
WaltForChar. 21-47 
WaitlO. 35-79 
WaltPort. 25-64 
WaraCaptura, 26-39 
Vfrlta, 31-31 
XREF. 2-33, 3-75, 67-18 
J.VO, 21-12, 67-18 
_I.VOAlart, 4-46 
-LVOParmlt, 2-75, 2-85 

-lntana. 2-33. 3-39. 2-44, 2-54, 2-61 
aS, 4-40, 4-43, 4-47 
»6. 4-40, 4-45, 4-46. 4-47 
aIND. 53-44 
aNEL. 53-45 
aRI, 53-46 
aRIN, 53-43 
aRIS. 53-43 
aSGRO. S3-48 
aSCR33. 53-50 
aSGR34, 53-52 
aSCRS, 53-49 
•SGR4, 53-51 
af_Typa. 17-64 
»l_Count, 55-98 
al_Fla9Ptr. 55-97 
ai_ElagTbl, 55-96 
al_MaxCount, 55-99 
al_VctrPtr. 55-95 
al_VetrTbl, 55-94 
alartNuabar, 4-39 
alraady, 4-204 
audio. davlea, 5-13 
bltanoda, 6-14 
bn_SIZEOF, 6-23 
bn_baaaayne. 6-30 
bnjBlltalia, 6-19 
bn_claanup, 6-31 
bn_duaay, 6-18 
bn_Cunetlon, 6-16 
,__ bn_n. 6-15 
, »»_Btat, 6-17 
ci_DaaCAddr. 13-19 
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d_DaatData. 13-33 
ciJMaltFoa. 13-21 



Ok 9 





ei_OpCoda. 
ci_SIZEOF. 


13-16 
13-24 








ci_WaitPo», 


13-18 








eijuctllat. 


13-17 








el_. 


13-36 








el_SIZEOF. 


13-44 








color. 


14-122 








coplnit. 


13-53 








copinit_dlagatrt. 


13-54 








copinit_apratop. 


13-56 








eopinl6_apratrtup. 


13-55 








count. 


21-10. 


21-12, 


21-13. 




cprllat, 
crl_N«xt, 


13-27 








13-20 








crl_SIZEOF. 


13-31 








crl_jaax. 


13-30 








crl_atart. 


13-29 








d7. 


4-40. 4 


-41, 4 


•47 




davicaa. 


35-14. 


38-48. 


38-52. 




dfh_DF. 


17-51 








dfh_FlloID. 


17-52 








dfh_Naa*. 


17-55 








dCh_Ravision, 


17-53 








d£h_SIZEOF, 


17-57 








d(h_Sogm*n6, 
dth_TF, 


17-54 








17-56 








disk. 


4-204 








diak.raaourca. 


16-101 








doa.l. 


22-25. 


60-23 






dp_Actlen. 


22-90 








dp_Argl, 


22-88, 


22-93 






dp_Llnk. 


22-77 








dp_I>ort. 


22-78 








dp_Ro»l. 


22-82. 


22-91 






dp_Raa2. 
dp_St»tua, 


22-86. 


22-92 






22-91 








dp_Stacua2, 


22-92 








dp-Typa. 
•xecbaaa.i. 


33-80. 
3-22 


22-90 






tc_Ell«N«M. 


17-26 








fe_Flaga. 
te_SXZBOF. 


17-29 
17-30 








fc_Stylo. 
fcjffliae. 


17-28 








17-27 








Ceh_FC, 


17-37 








fch_EilaID. 


17-35 








f ch_Nua£ntr lo» , 


17-36 








Oxju-gl. 


22-71 








ChJVrg3. 


22-72 








Oi^Argo. 


22-70, 


22-71 






Ch_Bu(. 


22-63 








«h_End, 


22-65 








fh_Funel, 


22-67 








fh_func3. 


22-68 
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(h_Func3, 


22-69 








fh_Funca, 


22-66. 


22-67 






£h_Intaractiv», 


22-61 








Ch_Unk, 


22-60 








(h_Po», 


22-64 








th_SIZEOF. 


22-73 








gbJkctlvUwi 


22-62 

31-20 








gb_Baaaayne, 


31-38 








9b_BlltLock, 


31-44 








gb_BlitNaat, 


31-45 








gb_BlitOmar, 


31-47 








gb_BlitWaitQ, 


31-46 








gbj>abug. 


31-37 








gb_DafaultFont, 


31-34 








gb_DiaplayFlaga, 


31-49 








gb_Flaga, 


31-43 








gb_LOFliae, 


31-24 








gb_Modaa. 


31-35 








ab_SHFllat, 


31-25 








gb_SIZE. 


31-53 








gb.SprltaRaaarvad, 


31-40 








gb_TOF_t*aitQ, 


31-48 








gb.TaxtFonta, 


31-33 








gb.VBlank, 


31-36 








gbj»llttar. 


31-33 








gbjalthd. 


31-36 








gb_bltarv, 


31-33 








gbj>lt«l. 


31-37 








gbjaablthd. 


31-38 








gb_bablttl. 


31-39 








gb_bytaraearvad. 


31-41 








gb_da. 


31-33 








gb_eoplnit. 


31-31 








gb_raaarvad. 


31-51 








gb_ayataa_bplconO . 


31-39 








gb.tlaarv. 


31-31 








gb_vbarv. 


31-30 








gg_Activation! 


4-304 








38-330 








ggJFlaga. 

gg_CadgatfD. 

gg_CaagatSandar, 


38-338 

38-360 
38-337 








gg_CadgatTaxt, 


38-343 
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Appendix F 
Exec Support Library 
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************************************************************************ 
* 

* Exec Support Functions -- NewLlst 

* 

****************************************************************** AAA 4 AA 

INCLUDE M exec/types.i" 
INCLUDE "exec/nodes. 1" 
INCLUDE "exec/1 ists.i" 

section _NewList 
xdef _NewList 

_NewList : 

move . 1 4 (sp) , aO 
NEWLIST aO 
rts 

end 
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INCLUDE "exec/types.!" 
INCLUDE "exec/nodes. i" 
INCLUDE "exec/lists. 1" 
INCLUDE "exec/libraries. i" 
INCLUDE "exec/ports. i" 
INCLUDE "exec/io.i" 



section JBeginIO 
xdef _BeginIO 

J3eginIO: 

move . 1 4 (sp) , al 

BEGINIO 

rts 

end 
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/ftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftft********************^ 

* 



*** 



* Exec Support Functions — Ports and Messages 
ft 

******************************************************************** 

#include "exec/types. h" 
#include "exec/nodes. h" 
#include "exec/lists. h" 
#include " exec/memory. h" 
#include "exec/interrupts. h" 
#include "exec/ports. h" 
#include "exec/1 ibraries.h" 
#include "exec/tasks .h M 
#include "exec/execbase.h" 

extern APTR AllocMem() ; 
extern UBYTE AllocSlgnal () ; 
extern struct Task *FindTask () ; 

struct MsgPort *CreatePort (name, pri) 
char *name; 
BYTE pr 1 ; 

i 

UBYTE slgBit; 

struct MsgPort *port; 

if ((sigBit = AllocSlgnal (-1)) == -1) 
return ( (struct MsgPort *) 0) ; 

port = AllocMem ( (ULONG) sizeof (*port) , MEMF_CLEAR | MEMFJ>UBLIC) ; 

if (port = 0) < 

FreeSignal (sigBit) ; 

return ( (struct MsgPort *) (0) ) ; 
} 

port -> mp_Node . ln_Name = name; 

port -> mp_J^ode . ln_Pri = pri; 

port -> mp.JJode . ln_Type = NT_MSGPORT; 

port -> mp_Flags = PA_SIGNAL; 

port -> mp_SigBlt = sigBit; 

port -> mp_SigTask = FindTask (0) ; 

if (name != 0) 

AddPort (port) ; 
else 

NewList (&(port -> mp_MsgList) ) ; 

return (port) ; 



/ 
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DeletePort (port) 

struct MsgPort *port; 

if ((port -> mp_JIode . lrxJSTame) != 0) 
RemPort (port) ; 

port -> mp_Node . lr\_Type = Oxff; 

port -> mp_MsgList . lhJHead = (struct Node *) - 1; 

FreeSlgnal (port -> mp_SlgBit) ; 

FreeMem (port, (ULONG) slzeof (*port) ) ; 
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Z***************************************************************,,,*^^^ 

* 

* Exec Support Functions -- Standard 10 Requests 
***************************************** A*****************************, 

#lnclude " exec/types. h" 

#lnclude "exec/nodes. h" 

#include "exec/lists .h" 

tlnclude "exec/memory. h" 

#lnclude "exec/interrupts. h" 

#lnclude "exec/ports. h" 

#lnclude "exec/1 ibraries.h" 

#include "exec/io.h" 

#lnclude "exec/tasks. h" 

#include "exec/execbase.h" 

extern APTR AllocMem() ; 

/****** exec_support/CreateStdIO ************************************** 

* 

* NAME 

* CreateStdIO () — create a standard 10 request 

* SYNOPSIS 

* ioStdReq = CreateStdIO (ioReplyPort) ; 

* FUNCTION 

* Allocates memory for and initializes a new 10 request block. 

* INPUTS 

* ioReplyPort - a pointer to an already initialized 

* message port to be used for this 10 request's 

* reply port. 

* 

* RESULT 

* Returns a pointer to the new block. Pointer is of the type: 

* struct IOStdReq 

* indicates inability to allocate enough memory for either 

* the request block. 
* 

* EXAMPLE 

* struct IOStdReq *myBlock; 

* if( (myBlock = CreateStdIO (myPort) ) = NULL) 

* printf ("Insufficient memory or not enough signals!"); 

* SEE ALSO 

* DeleteStdIO 

* 

***********************************************************************/ 

struct IOStdReq *CreateStdIO (IoReplyPort) 
struct MsgPort * IoReplyPort; 

struct IOStdReq * ioStdReq; 
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if (ioReplyPort = 0) 

return ( (struct IOStdReq *) 0) ; 

ioStdReq = AllocMem (sizeof (*ioStdReq) , MEMF_CLEAR | MEMF_J>UBLIC) ; 

if (ioStdReq = 0) 

return ( (struct IOStdReq *) 0) ; 

ioStdReq -> io.Jfessage.mn_Node.ln_Type = NT_MESSAGE; 
IoStdReq -> io_Message.mn_jNode.ln_J > ri = 0; 

ioStdReq -> ioJMessage.mnJReplyPort = ioReplyPort; 

return (ioStdReq) ; 



/****** exec_support/DeleteStdI *************************************** 

* 

* NAME 

* Deletes tdIO (ioStdReq) - return memory allocated for 10 request 

* SYNOPSIS 

* DeleteStdIO (ioStdReq) ; 

* FUNCTION 
See summary line at NAME. Also frees the signal bit which 



* 



* had been allocated by the call to CreateStdlO. 



* 

* INPUTS 



* 



* A pointer to the IOStdReq block whose resources are to be freed. 

* RESULT 

* Frees the memory. Returns (no error conditions shown) 

* EXAMPLE 
struct IOStdReq *myBlock; 

* DeleteStdIO (myBlock) ; 

* SEE ALSO 

* CreateStdlO 

* 

it************************************************************************/ 

DeleteStdIO (ioStdReq) 

struct IOStdReq * ioStdReq; 

IoStdReq -> io_Message.mn_Node.ln_Type = Oxff; 
ioStdReq -> io_J3evice = (struct Device *) -1; 
ioStdReq -> loJUhit = (struct Unit *) -1; 

FreeMem (ioStdReq, sizeof (*ioStdReq) ) ; 
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# include "exec/types. h" 
# include "exec/nodes. h" 
# include "exec/lists. h" 
#include "exec/memory. h" 
#include "exec/interrupts. h" 
#include "exec/ports. h" 
# include "exec/libraries. h" 
#include "exec/tasks. h" 
#include "exec/execbase.h" 

extern APTR AllocMemO; 

extern struct Task *FindTask(); 

/* 

* Create a task with given name, priority, and stack size. 

* It will use the default exception and trap handlers for now. 
*/ 

struct Task *CreateTask(name, pri, initPC, stackSize) 
char *name; 
UBYTE pri; 
APTR initPC; 
ULONG stackSize; 



{ 



struct Task *newTask; 

ULONG dataSize = (stackSize & Oxfffffc) + 1; 

/* 

* This should be broken into two allocations: task of PUBLIC 

* and stack of PRIVATE 
*/ 

newTask = AllocMem ((ULONG) sizeof (*newTask) + dataSize, 

MEMF_CLEAR |MEMF_PUBLIC) ; 

if ( ! (ULONG) newTask) { 

return ((struct Task *) (0)); 

} 

newTask -> tc_SPLower = (APTR) ((long) newTask + (long) sizeof (*newTask)); 
newTask -> tc_SPUpper = (APTR) (( (ULONG) (newTask -> tc_SPLower) + dataSize) 

& Oxf f f f fe) ; 
newTask -> tc_SPReg = (APTR) ((long) (newTask -> tc_SPUpper) ) ; 

newTask -> tc_Node . ln_Type = NTJTASK; 
newTask -> tc_Node.ln_Pri = pri; 
newTask -> tc_Node . ln_Name = name ; 

AddTask (newTask, initPC, 0); 
return (newTask) ; 



DeleteTask(tc) 

struct Task *tc; 

{ 

RemTask (tc) ; /* does not handle self deletion properly */ 
FreeMem (tc, 1 + (ULONG) (tc -> tc_SPUpper) - (ULONG) tc) ; 
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* 

* Exec Support Function -- Extended 10 Request 

ttinclude " exec/types. h" 
ttinclude "exec/nodes. h" 
ttinclude "exec/1 ists.h" 
ttinclude "exec/memory. h" 
#lnclude "exec/Interrupts. h" 
ttinclude "exec/ports. h" 
#include "exec/libraries. h" 
ttinclude "exec/io.h" 
ttinclude "exec/tasks .h" 
ttinclude "exec/execbase.h" 

extern APTR AllocMem() ; 

/****** exec_support/CreateExtIO ************************************** 

* 

* NAME 

* CreateExtIO () -- create an Extended 10 request 

* SYNOPSIS 

* ioReq = CreateExtIO (ioReplyPort, size) ; 

* FUNCTION 

* Allocates memory for and Initializes a new 10 request block 

* of a user- specified number of bytes. 
* 

* INPUTS 

* ioReplyPort - a pointer to an already initialized 

* message port to be used for this 10 request's reply port. 

* RESULT 

* Returns a pointer to the new block. Pointer is of the type 

* struct IORequest. 
* 

* indicates inability to allocate enough memory for the request block 

* or not enough signals available. 

* 

* EXAMPLE 
struct IORequest *myBlock; 
if( (myBlock = CreateExtIO (myPort, sizeof (struct IOExtTD)) — NULL) 

exit (NO_MEM_OR_SIGNALS) ; 



* example used to allocate space for IOExtTD (trackdisk driver 

* 10 Request block for extended 10 operations) . 



* SEE ALSO 

* DeleteExtIO 

* 



***********************************************************************/ 
struct IORequest *CreateExtIO(ioReplyPort,size) 
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struct MsgPort *ioReplyPort; 
LONG size; 

{ 

struct IORequest *ioReq; 

if (ioReplyPort == 0) 

return ( (struct IORequest *) 0) ; 

loReq = (struct IORequest *)AllocMem (size, MEMF_CLEAR | MEMF_PUBLIC) ; 

if (ioReq = 0) 

return ( (struct IORequest *) 0) ; 

ioReq -> lo_Jfessage.mn_Node.ln_Type = NT_MESSAGE; 
ioReq -> io_Message.mn_ - Node.ln_Pri = 0; 

ioReq -> io_Message.mn_ReplyPort = ioReplyPort; 
return (ioReq) ; 

/****** exec_support/DeleteExtIO ************************************** 



* 

* NAME 



* DeleteExtIO () - return memory allocated for extended 10 request 



* 

* SYNOPSIS 

* 



DeleteExtIO (ioReq, size) ; 

* FUNCTION 

* See summary line at NAME. Also frees the signal bit which 

* had been allocated by the call to CreateExtlO. 

* INPUTS 

* A pointer to the IORequest block whose resources are to be freed. 



* 

* RESULT 
* 

* 

* EXAMPLE 

* 

* 
* 

* 
* 
* 

* SEE ALSO 

* CreateExtlO 



Frees the memory. Returns (no error conditions shown) 

PLE 

struct IORequest *myBlock; 

DeleteExtIO (myBlock, (sizeof (struct IOExtTD))); 

example shows that CreateExtlO had been used to create a trackdisk 
(extended) 10 Request block. 



* 

DeleteExtIO (ioExt, size) 

struct IORequest *ioExt; 

LONG size; 
{ 

ioExt -> lo_Message.mrL-Node.ln_Type = Oxff; 
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loExt -> io_Device = (struct Device *) -1; 
ioExt -> lo_Unit = (struct Unit *) -1; 

FreeMem (ioExt, size) ; 



\ 



Dec 9 14:25 1985 Debug . Library . Doc Page 1 



TABLE OF CONTENTS 

debug . lib/KDoFmt ; 
debug . 1 ib/KGetChar ; 
debug . 1 ib/KMayGetChar ; 
debug . llb/KPutChar ; 
debug . 1 ib/KPutFmt ; 
debug . lib/KPutStr ; 



INTRODUCTION 

This section outlines the routines available in the debug. lib. 

The debug. lib is a linked- library rather than a shared library. 
You link to it at compile/link time rather than opening a library. 
This link-library becomes a physical part of your program code. 

Routines that are described in the ROM Kernel manual as well as 

those listed here, can be called directly from tasks. Routines 

that are listed in the Lattice C manual, such as printf, and scanf 

for example, should only be called from a process, rather than from 

a task in that they require a process model in order to function. 

A process is started when you ask AmigaDOS to run your program. Any 

part of main() or any routines it calls become part of that process. 

If your program spawns any tasks on its own, to have those tasks 

execute any process -dependent code, the tasks should either send messages 

back to the main program, which in turn executes the appropriate code, 

or use these debug routines if the programmer has connected a 9600 

baud device to the Amiga's serial port. 

To start the debug mode correctly, you can set the serial port parameters 
by calling 

romwack 
from a CLI . Then, from the external terminal, type 
go 

The port is now set up and ready to go. The debug print and get-character 
routines will function as described below. 
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debug. lib/KDoFmt debug. lib/KDoFmt 

NAME 

KDoFmt -- format data into a character stream. 

SYNOPSIS 

KDoFmt (FormatString, DataStream, PutChProc, PutChData)- 
AO Al A2 A3 

FUNCTION 

perform "C"- language- like formatting of a data stream, 
outputting the result a character at a time 

INPUTS 

FormatString - a "C"- language- like null terminated format 

string, with the following supported % types: 
DataStream - a stream of data that. is interpreted according to 

the format string. 
PutChProc - the procedure to call with each character to be 
output, called as: 
PutChProc (Char, PutChData); 
D0-0:8 A3 
the procedure is called with a null Char at the end of 
the format string. 
PutChData - an address register, that passes thru to PutChProc 



\ 
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debug . 1 ib/KGetChar .. 

debug . 1 ib/KGetChar 

NAME 

KGetChar - get a character from the debug- console (a 9600 baud 
device attached to the serial port of the Amiga.) 

SYNOPSIS 

char = KGetChar () ; 
DO 

FUNCTION 

get the next character from the debug-console device. 



Dec 9 14:25 1985 Debug . Library . Doc Page 4 

debug . lib/KMayGetChar debug . lib/KMayGetChar 

NAME 

KMayGetChar - return a char iff present, but don't block, 
(device attached serial port) . 

SYNOPSIS 

f lagChar = KMayGetChar () ; 
DO 

FUNCTION 

return either a -1, saying that there is no char present, or 
the char that was waiting 



V 

V 
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debug . 1 ib/KPutChar . debug . 1 ib/KPutChar 

NAME 

KPutChar - put a character to the debug-console 

(device attached to Amiga serial port) . 

SYNOPSIS 

char = KPutChar (char) ; 
DO DO 

FUNCTION 

put a character to the debug-console device. 
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debug. llb/KPutFmt . . 

debug . 1 ib/KPutFmt 

NAME 

KPutFmt - print formatted data to the debug-console 
(device attached to Amiga serial port) . 

SYNOPSIS 

KPutFmt (format, values) ; 
AO Al 

FUNCTION 

print formatted data to the debug-console device 
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debug . lib/KPutStr debu 9 • Hb/KPutStr 

NAME 

KPutStr - put a string to the debug-console 

(attached to the Amiga serial port) . 

SYNOPSIS 

KPutStr (string) 
AO 

FUNCTION 

put a null terminated string to the debug-console device. 



Appendix G 
AmigaDOS Topics 



The Amiga ROM Kernel Manual has become somewhat more that just a document covering 
the ROM Kernel. The name has been kept for historical reasons even though, as of this 
writing, the "ROM" software loads into kickstart RAM. 

Certain topics were not available as of the most recent revision of the AmigaDOS manuals 
and are, therefore, included here to assure that Amiga developers will have the latest avail- 
able information on these topics. 

These DOS-related topics, which are additional information for the AmigaDOS Technical 
Reference Manual, are outlined on the following pages. 
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Appendix H 
IFF Interchange File Format 



This appendix contains a document developed jointly by Commodore-Amiga and Electronic 
Arts. 

The document contained here includes source code for routines that will both read and write 
this data format. 

Commodore- Amiga has adopted this data interchange file format for our internal use and we 
recommend that our developers adopt it as well. 
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INFORMATION ABOUT COMPILING THESE ROUTINES: 

Electronic arts apparently keeps a bunch of includes in a file called 
"graphics/system. h" . 

This is the contents of that include-f ile: 

#include exec/types. h 
# include exec/exec. h 
#include graphics/gfx.h 
#include graphics/gf xbase . h 
#include graphics/copper. h 
#include graphics/gels. h 
#include graphics/regions. h 
#include hardware/blit.h 
#include devices/keymap.h 
#include intuition/ intuition. h 
#include intuition/ intuitionbase.h 
#include libraries/dos.h 

OFFSET_BEGINNING in iffr.c and iffw.c must be changed to 
OFFSET_BEGINING. It is spelled differently in libraries/dos.h. 

In Ilbmr.c (p. 3) there is a call to UnPackRow: 

UnPackRow (&buf, *pDest, nFilled, srcRowBytes) 

nFilled and srcRowBytes are defined as int and LONG. 
The function expects WORD and WORD. To compile with 
native Lattice required: 

UnPackRow (&buf, *pDest, (WORD) nFilled, (WORD) srcRowBytes) 



"EA IFF 85" Standard for Interchange Format Files 



Document Date: November 15, 1985 

From: Jerry Morrison, Electronic Arts 

Status of Standard: Released and in use 



1. Introduction 



Standards are Good for Software Developers 



As home computer hardware evolves to better and better media machines, the demand increases for 
higher quality, more detailed data. Data development gets more expensive, requires more expertise and 
better tools, and has to be shared across projects. Think about several ports of a product on one CD-ROM 
with 500M Bytes of common data! 

Development tools need standard interchange file formats. Imagine scanning in images of "player" 
shapes, moving them to a paint program for editing, then incorporating them into a game. Or writing a 
theme song with a Macintosh score editor and incorporating it into an Amiga game. The data must at times 
be transformed, clipped, filled out, and moved across machine kinds. Media projects will depend on data 
transfer from graphic, music, sound effect, animation, and script tools. 

Standards are Good for Software Users 

Customers should be able to move their own data between independently developed software products. 
And they should be able to buy data libraries usable across many such products. The types of data objects 
to exchange are open-ended and include plain and formatted text, raster and structured graphics, fonts, 
music, sound effects, musical instrument descriptions, and animation. 

The problem with expedient file formats— typically memory dumps— is that they're too provincial. By 
designing data for one particular use (e.g. a screen snapshot), they preclude future expansion (would you 
like a full page picture? a mufti-page document?). In neglecting the possibility that other programs might 
read their data, they fall to save contextual information (how many bit planes? what resolution?). Ignoring 
that other programs might create such files, they're intolerant of extra data (texture palette for a picture 
editor), missing data (no color map), or minor variations (smaller image). In practice, a filed representation 
should faaly. mirror an in-memory representation. The former should be designed for longevity; the latter 
to optimize the manipulations of a particular program. The same filed data win be read into different memory 
formats by different programs. 

The IFF philosophy: "A little behind-the-scenes conversion when programs read and write files is far better 
than NxM explicit conversion utilities for highly specialized formats." 

So we need some standardization for data interchange among development tools and products. The more 
developers that adopt a standard, the better for all of us and our customers. 

Hers is "EA IFF 1985" 

V^SZlSS!* !!2?!S? *!* ,FF Standard ,or &«<*™e° B* B>rmat. The full name is "EA IFF 
2™ J* *£* " and * JS, .? i ? ations are inc luded tor certain choices. Public domain subroutine packages 
and utility programs are available to make it easy to write and use IFF-compatible programs 
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Part 1 introduces the standard. Part 2 presents its requirements and background. Parts 3, 4, and 5 define 
the primitive data types, FORMs, and USTs, respectively, and how to define new high level types. Part 6 
specifies the top level file structure. Appendix A is included for quick reference and Appendix B names 
the committee responsible for this standard. 

References 

American National Standard Additional SSiftoJ SfldfiS iPl Usa Bdttl A3CJ1, ANSI standard 3.64-1979 tor an 
8-bit character set. See also ISO standard 2022 and ISC7DIS standard 6429.2. 

Amiga™ is a trademark of Commodore-Amiga, Inc. 

Compiler Construction . An Advanced Course , edited by F. L Bauer and J. Eickel (Springer-Verlag. 1976). 
This book is one of many sources for information on recursive descent parsing. 

DIF Technical Specification © 1981 by Software Arts. Inc. DIF™ is the format for spreadsheet data 
interchange developed by Software Arts, Inc. 
DIF™ is a trademark of Software Arts, Inc. 

Electronic Arts™ is a trademark of Electronic Arts. 

"FDCT IFF Formatted Text, from Electronic Arts. IFF supplement document for a text format. 

Inside Macintosh © 1982, 1983, 1984, 1985 Apple Computer, Inc., a programmer's reference manual. 
Apple® is a trademark of Apple Computer, Inc. 
Macintosh™ is a trademark licensed to Apple Computer, Inc. 

»ILBM' IFF interleaved BJmatt, from Electronic Arts. IFF supplement document for a raster image format. 

M680Q0 16/32-Bit Microprocessor Programmer's Reference MaOl-fli © 1984, 1982, 1980. 1979 by 
Motorola, inc. 

PostScript Language Mjoyjl © 1984 Adobe Systems Incorporated. 
PostScript™ is a trademark of Adobe Systems, Inc. 
Times and Helvetica© are trademarks of Allied Corporation. 

interScrtat: A Proposal for a Standard for thft Interchange Pi Fdttahle Documents © 1984 Xerox 

Corporation. 

Introduction fo InterScriot © 1985 Xerox Corporation. 
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2. Background for Designers 

Part 2 is about the background, requirements, and goals for the standard. It's geared for people who want 
to design new types of IFF objects. People just interested in using the standard may wish to skip this part 

What Do We Need? 

A standard should be long on prescription and short on overhead. It should give lots of rules for designing 
programs and data files for synergy. But neither the programs nor the files should cost too much more than 
the expedient variety. While we're looking to a future with CD-ROMs and perpendicular recording, the 
standard must work well on floppy disks. 

For program portability, simplicity, and efficiency, formats should be designed with more than one 
implementation style in mind. (In practice, pure stream I/O is adequate although random access makes it 
easier to write files.) It ought to be possible to read one of many objects in a file without scanning all the 
preceding data. Some programs need to read and play out their data in real time, so we need good 
compromises between generality and efficiency. 

As much as we need standards, they canl hold up product schedules. So we also need a kind of 
decentralized extensfeility where any software developer can define and refine new object types without 
some "standards authority" in the loop. Developers must be able to extend existing formats in a forward- 
arid backward-compatible way. A central repository for design information and example programs can help 
us take full advantage of the standard. 

For convenience, data formats should heed the restrictions of various processors and environments. E.g. 
word-alignment greatly helps 68000 access at insignificant cost to 8088 programs. 

Other goals include the ability to share common elements over a list of objects and the ability to construct 
composite objects containing other data objects with structural information like directories. 

"Simple things should be simple and complex things should be possible." 

Think Ahead 

Let's think ahead and build programs that read and write files for each other and for programs yet to be 
designed. Build data formats to last for future computers so long as the overhead is acceptable This 
extends the usefulness and life of today's programs and data. 

To maximize interconnectivity, the standard file structure and the specific object formats must all be 
general and extensible. Think ahead when designing an object. It should serve many purposes and allow 
many programs to store and read back all the information they need; even squeeze in custom data Then a 
programmer can store the available data and is encouraged to include fixed contextual details Recipient 

2S r !Tl!^ r9ad ? e needed parts ' skip unrecognized stuff, default missing data, and use the stored 
context to help transform the data as needed. 

Scope 
!T«fi^ r i!? S thes L needs |V ^fining a standard file structure, some initial data object types, ways to 

according to this standard but don't expect direct compatibility with existing software. We'll need 
converswn programs to bridge the gap from the old world. «*.«*« rw«j 
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IFF is geared tor computers that readily process information in 8-bit bytes. It assumes a "physical layer" of 
data storage and trarsmission that reliably maintains f les" as strings of 8-bit bytes. The standard treats a 
■file" as a container of data bytes and is independent of how to find a file and whether ft has a byte count. 

This standard does not by Itself Implement a clipboard for cutting and pasting data between programs. A 
clipboard needs software to mediate access, to maintain a ^contents version number" so programs can 
detect updates, and to manage the data in "virtual memory". 

Previous Work 

Where our needs are similar, we borrow from existing standards. 

Our basic need to move data between independently developed programs is similar to that addressed by 
the Apple Macintosh desk scrap or "clipboard" (Inside Macintosh chapter "Scrap Manager"]- The Scrap 
Manager works closely with the Resource Manager, a handy fHer and swapper for data objects (text strings, 
dialog window templates, pictures, fonts. . .) including types yet to be designed [losidfl Macintosh chapter 
"Resource Manager"!- The Resource Manager is a kin to Smalltalk's object swapper. 

We will probably write a Macintosh desk accessory that converts IFF files to and from the Macintosh 
clipboard for quick and easy interchange with programs Ike MacPaint and Resource Mover. 

Macintosh uses a simple and elegant scheme of 4-character "identifiers" to identify resource types, 
clipboard format types, file types, and file creator programs. Alternatives are unique ID numbers assigned 
by a central authority or by hierarchical authorities, unique ID numbers generated by algorithm, other fixed 
length character strings, and variable length strings. Character string identifiers double as readable 
signposts in data files and programs. The choice of 4 characters is a good tradeoff between storage space, 
fetch/compare/store time, and name space size. We'll honor Apple's designers by adopting this scheme. 

"PICT" is a good example of a standard structured graphics format (including raster images) and its many 
uses [Inside Macintosh chapter "QuickDraw"!. Macintosh provides QuickDraw routines in ROM to create, 
manipulate, and display PICTs. Any application can create a PICT by simply asking QuickDraw to record a 
sequence of drawing commands. Since it's just as easy to ask QuickDraw to render a PICT to a screen or a 
printer it's very effective to pass them between programs, say from an illustrator to a word processor. An 
important feature is the ability to store "comments" in a PICT which QuickDraw wffl ignore. Actually, it 
passes them to your optional custom "comment handler". 

PostScrfet, Adobe's print file standard, is a more general way to represent any print image (which tea 
specification for putting marks on paper) [EoslSCTJEl Language. MaouaD- In fact, PostScript is a full-fledged 
programming language. To interpret a PostScript program is to render a document on a raster output 
device. The language is defined in layers: a lexical layer of identifiers, constants, and operators; a layer of 
reverse polish semantics including scope rules and a way to define new subroutines; and a 
printing-specific layer of built-in identifiers and operators for rendering graphic images. It is clearly a 
powerful (Turing equivalent) image definition language. PICT and a subset of PostScript are candidates for 
structured graphics standards. 

A PostScript document can be printed on any raster output device (including a display) but cannot 
generally be edited. That's because the original flexibility and constraints have been discarded. Besides, a 
PostScript program may use arbitrary computation to supply parameters like placement and size to «ach 
operator. A QuickDraw PICT, in comparison, is a more restricted format of graphic primitives parameterized 
by constants. So a PICT can be edited at the level of the primitives, e.g. move or thicken a line. It cannot be 
edited at the higher level of, say, the bar chart data which generated the picture. 

PostScript has another limitation: Not all kinds of data amount to marks on paper. A musical instrument 
description is one example. PostScript te just not geared for such uses. 
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"DIP is another example of data being stored in a general format usable by future programs [Q|f Technical 
Specification! DIF is a format for spreadsheet data interchange. DIF and PostScript are both expressed? 
plain ASCII text files. This is very handy for printing, debugging, experimenting, and transmitting across 
modems. It can have substantial cost in compaction and read/write work, depending on use. We won't 
store IFF files this way but we could define an ASCII alternate representation with a converter program. 

InterScript is Xerox* standard for interchange of editable documents prereduction jg InterScripfl it 
approaches a harder problem: How to represent editable word processor documents that may contain 
formatted text, pictures, cross-references Ike figure numbers, and even highly specialized objects like 
mathematical equations? InterScript aims to define one standard representation for each kind of 
information. Each InterScript-compatible editor is supposed to preserve the objects it doesn't understand 
and even maintain nested cross-references. So a simple word processor would let you edit the text of a 
fancy document without discarding the equations or disrupting the equation numbers. 

Our task is similarly to store high level information and preserve as much content as practical while moving it 
between programs. But we need to span a larger universe of data types and cannot expect to centrally 
define them all. Fortunately, we don't need to make programs preserve information that they don't 
understand. And for better or worse, we don't have to tackle cross-references yet. 
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3. Primitive Data Types 

Atomic components such as integers and characters that are interpretable directly by the CPU are 
\SSSS!XSZi most convenient for the Motorola MC68000 processor [MSSQQu ifE&Bit 
Mternnmcessor Programmer's Reference Manual]- 

N B • Part 3 dictates the format for "primitive' data types where— and only where-used in the overall file 
structure and standard kinds of chunks (Cf. Chunks). The number of such occurrences will be small 
enough that the costs of conversion, storage, and management of processor-specific files would far 
exceed the costs of conversion on-the-fly by foreign- programs. A particular data chunk may be specified 
with a different format for its internal primitive types or with processor- or environment-specific vanants if 
necessary to optimize local usage. Since that hurts data interchange, it's not recommended. (Cf . 
Designing New Data Sections, in Part 4.) 

Alignment 

All data objects larger than a byte are aligned on fly^n byte addresses relative to the start of the file. This 
may require padding. Pad bytes are to be written as zeros, but donl count on that when reading. 

This means that every odd-length "chunk- (see below) must be padded so that the next one will fall on an 
even boundary. Also, designers of structures to be stored in chunks should include pad fields where 
needed to align every field larger than a byte. Zeros should be stored in all the pad bytes. 

Justification: Even-alignment causes a little extra work for files that are used only on certain processors but 
allows 68000 programs to construct and scan the data in memory and do block I/O. You just add an 
occasional pad field to data structures that you're going to block read/write or else stream read/write an 
extra byte. And the same source code works on all processors. Unspecified alignment, on the other hand, 
would force 68000 programs to (dis)assemble word and long-word data one byte at a time. Pretty 
cumbersome in a high level language. And H you donl conditionally compile that out for other processors, 
you won't gain anything. 

Number* 

Numeric types supported are two's complement binary integers in the format used by the MC68000 
processor— high byte first, high word first— 4he reverse of 8088 and 6502 format. They could potentially 
include signed and unsigned 8, 16, and 32 bit integers but the standard only uses the following (in C): 

typedef unsigned char UBYTE; /* 8 bits unsigned */ 

typedef short WORD; /* 16 bits signed */ 

typedef unsigned short WORD; /* 16 bits unsigned */ 

typedef long LONG; /* 32 bits signed ■*/ 

Characters 

The following character set is assumed wherever characters are used, e.g. in text strings, IDs, and TEXT 
chunks (see below). 

Characters are encoded in 8-bit ASCII. Characters in the range NUL (hex 0) through DEL (hex 7F) are well 
defined by the 7-bit ASCII standard. IFF uses the graphic group " " (SP, hex 20) through "-' (hex 7E). 

Most of the control character group hex 01 through hex 1 F have no standard meaning in IFF. The control 
character LF (hex 0A) is defined as a "newline" character. It denotes an intentional line break, that is, a 



-H-6- 



Electronic Arts EAIFF85 Commodore-Amiga 

paragraph or line terminator. (There is no way to store an automatic line break. That is strictly a function of 
the margins in the environment the text is placed.) The control character ESC (hex 1 B) is a reserved 
escape character under the rules of ANSI standard 3.64-1979 Ajmrjcan National Standard Additional 
Control Codes for Use with ASCII. ISO standard 2022, and ISO/DIS standard 6429.2. 

Characters In the range hex 7F through hex FF are not globally defined in IFF. They are best left reserved 
for future standardization. But note that the FORM type FTXT (formatted text) defines the meaning of 
these characters within FTXT forms. In particular, character values hex 7F through hex 9F are control codes 
while characters hex A0 through hex FF are extended graphic characters like A, as per the ISO and ANSI 
standards cited above. [See the supplementary document •FTXT" IFF Formatted Text. ] 

Dates 

A "creation date" is defined as the date and time a stream of data bytes was created. (Some systems call 
this a "last modified date".) Editing some data changes its creation date. Moving the data between volumes 
or machines does not. 

The IFF standard date format will be one of those used in MS-DOS, Macintosh, or Amiga DOS (probably a 
32-bit unsigned number of seconds since a reference point). Issue: Investigate these three. 

Type IDs 

A "type ID", "property name", "FORM type", or any other IFF identifier is a 32-bH value: the concatenation 
of four ASCII characters in the range " " (SP, hex 20) through "-" (hex 7E). Spaces (hex 20) should not 
precede printing characters; trailing spaces are ok. Control characters are forbidden. 

typedef CHAR ID [4]; 

IDs are compared using a simple 32-bit case-dependent equality test. 

Data section type IDs (aka FORM types) are restriced IDs. (Cf. Data Sections.) Since they may be stored in 
filename extensions (Cf. Single Purpose Files) lower case letters and punctuation marks are forbidden. 
TraiBng spaces are ok. 

Carefully choose those four characters when you pick a new ID. Make them mnemonic so programmers 
can look at an interchange format file and figure out what kind of data it contains. The name space makes it 
possible for developers scattered around the globe to generate ID values with minimal collisions so long as 
they choose specific names like "MUS4" instead of general ones like "TYPE" and "FILE". EA will "register- 
new FORM type IDs and format descriptions as they're devised, but collisions will be improbable so there 
will be no pressure on this "clearinghouse" process. Appendix A has a list of currently defined IDs. 

Sometimes it's necessary to make data format changes that arenl backward compatible. Since IDs are 
used to denote data formats in IFF, new IDs are chosen to denote revised formats. Since programs wont 
read chunks whose IDs they dont recognize (see Chunks, below), the new IDs keep old programs from 
stumbling over new data. The conventional way to chose a "revision" ID is to increment the last character if 
it's a digit or else change the last character to a digit. E.g. first and second revisions of the ID "XY" would be 
"XY1" and "XY2". Revisions of "CMAP" would be "CMA1" and "CMA2". 

Chunks 
Chunks are the building blocks in the IFF structure. The form (in C) is 
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typedef struct { 
ID ckiD; 

LONG ckSize; /* ai*«of (ckData) */ 

UBYTE ckDataf,/* ckSize */]; 
) Chunk; 

The fixed header part means "Here's another ckiD type chunk, ckSize bytes long." 

The ckiD identifies the format and purpose of the chunk. As a rule, a program must recognize ckiD to 
interpret ckData. It should skip over all unrecognized chunks. The cJcid also serves as a format version 
number as long as we pick new IDs to identify new formats of ckData (see above). 

The following ckiDS are universally reserved to identify chunks with particular IFF meanings: "LIST", 
"FORM", "PROP, "CAT ", and " ".The special ID " " (4 spaces) is a ckiD for "filler" chunks, that is, 
chunks that fill space but have no meaningful contents. The IDs "LIS1" through "LIS9", "FORI" through 
"FOR9", and "CAT1" through "CAT9" are reserved for future "version number" variations. AW 
IFF-compatible software must account for these 23 chunk IDs. Appendix A has a list of predefined IDs. 

The ckSize is a logical block size— how many data bytes are in ckData. H ckData is an odd number of 
bytes long, a pad byte follows which is rjgl included in ckSize. (Cf. Alignment.) A chunk's total physical 
size is ckSize rounded up to an even number plus the size of the header. So the smallest chunk is 8 
bytes long with ckSize - 0. For the sake of following chunks, programs must respect every chunk's 
ckSize as a virtual end-of-file for reading its ckData even if that data is malformed, e.g. H nested contents 
are truncated. 

We can describe the syntax of a chunk as a regular expression with "#" representing the cksize, i.e. the 
length of the following {braced} bytes. The " [0] " represents a sometimes needed pad byte. (The regular 
expressions in this document are collected in Appendix A along with an explanation of notation.) 

Chunk ::- ID #{ UBYTE* } [0] 

One chunk output technique is to stream write a chunk header, stream write the chunk contents, then 
random access back to the header to fill in the size. Another technique is to make a preliminary pass over 
the data to compute the size, then write it out all at once. 

Strings, String Chunks, and String Properties 

In a string of ASCII text, LF denotes a forced line break (paragraph or line terminator). Other control 
characters are not used. (Cf. Characters.) 

The ckiD for a chunk that contains a string of plain, unformatted text is "TEXT. As aoractteal matter, a text 
string should probably not be longer than 32767 bytes. The standard allows up to 2* 1 - 1 bytes. 

When used as a data property (see below), atext string chunk may be to 255 characters long Such a 
string is readily converted to a C string or a Pascal string 1255] . The ckiD of a property must be the 
property name, not "TEXT". 

When used as a carl of a chunk or data property, restricted C string format is normally used. That means 
to 255 characters followed by a NUL byte (ASCII value 0). 

Data Properties 
Data properties specify attributes for following (non-property) chunks. A data property essentially says 



-H-8- 



Electronic Arts EAIFF85 Commodore-Amiga 

"identifier - value", for example "XY - (10. 200)", telling something about following chunks. Properties mav 
only appear inside data sections ("FORM" chunks, cf. Data Sections) and property sections ("PROP" 
chunks, cf. Group PROP). 

The form of a data property is a special case of Chunk. The c Jcid is a property name as well as a property 
type. The cksize should be small since data properties are intended to be accumulated in RAM when 
reading a file. (256 bytes is a reasonable upper bound.) Syntactically: 

Property : :- Chunk 

When designing a data object, use properties to describe context information Vke the size of an image, 
even if they donl vary in your program. Other programs will need this information. 

Think of property settings as assignments to variables in a programming language. Multiple assignments 
are redundant and local assignments temporarily override global assignments. The order of assignments 
doesn't matter as long as they precede the affected chunks. (Cf. LISTs, CATs, and Shared Properties.) 

Each object type (FORM type) is a local name space for property IDs. Think of a "CMAP" property in a 
"FORM ILBM" as the qualified ID "ILBM.CMAP". Property IDs specified when an object type is designed 
(and therefore known to all clients) are called "standard" while specialized ones added later are 
"nonstandard". 



Links 

Issue: A standard mechanism for "links" or "cross references" is very desirable for things like combining 
images and sounds into animations. Perhaps we'll define "link" chunks within FORMs that refer to other 
FORMs or to specific chunks within the same and other FORMs. This needs further work. EA IFF 1985 has 
no standard link mechanism. 

For now, it may suffice to read a list of, say, musical instruments, and then just refer to them within a musical 
score by index number. 

File References 

Issue: We may need a standard form for references to other files. A "file ref" would name a directory and a 
file in the same type of operating system as the ref s originator. Following the reference would expect the 
file to be on some mounted volume. In a network environment, a file ref could name a server, too. 

Issue: What about a means to reference a portion of another file? Would this be a "file ref plus a reference 
to a "link" within the target file? 
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4. Data Sections 

The first thing we need of a file is to teB if It contains IFF data or not and. If so, does It contain the kind of 
data we're looking for? So we come to the notion of a 'data section". 

A -data section" or "data object" or IFF "FORM" is the main point of an IFF file. It is one high level object 
such m apSre or wund effect; self-contained and self-identifying. It could be a composite object like a 
musical score with nested musical instrument descriptions. 

Group FORM 
A data section is a chunk with ckiD "FORM" and this arrangement: 

FORM ::- "FORM" #{ FormType (LocalChunk I FORM I LIST | CAT)* } 



FormType 
LocalChunk 



- ID 

- Property I Chunk 



The ID "FORM" is a syntactic keyword like "struct" in C. Think of a "struct ILBM" containing a field "CMAP". If 
you see "FORM" you'll know to expect a FORM type ID (the structure name, "ILBM" In this example) and a 
Particular corterrtsTrrangement or "syntax" (local chunks, FORMs, LISTs. and CATsV OJBTUnd CATs are 
discussed in part 5, below.) A "FORM ILBM", in particular, might contain a local chunk "CMAP", an 
"ILBM.CMAP" (to use a qualified name). 

So the chunk ID "FORM" indicates a data section. It implies that the chunk contains an ID and some 
number of nested chunks. In reading a FORM, like any other chunk, programs must respect its cksize as 
a virtual end-of-file for reading its contents, even if they're truncated. 

The FormType (or FORM type) is a restricted ID that may not contain lower case letters or punctuation 
characters. (Cf. Type IDs. Cf . Single Purpose Files.) 

The type-specific information in a FORM is composed of its "local chunks": data properties and other 
chunks. Each FORM type is a local name space for local chunk IDs. So "CMAP" local chunks in other 
FORM types may be unrelated to "ILBM.CMAP". More than that, each FORM type defines semantic 
scope. If you know what a FORM ILBM is. you'll know what an ILBM.CMAP is. 

Local chunks defined when the FORM type is designed (and therefore known to all clients of this type) are 
called "standard" while specialized ones added later are "nonstandard". 

Among the local chunks, property chunks give settings for various details like text font while the other 
chunks supply the essential information. This distinction is not clear cut. A property setting cancelled by a 
later setting of the same property has effect only on data chunks in between. E.g. in the sequence: 

propl - x (propN - value)* propl - y 
where the propNS are not propi, the setting propi - x has no effect. 

The following universal chunk IDs are reserved inside any FORM: "LIST", "FORM", "PROP, "CAT ". 
" ", "LIS1" through "LIS9", "FORI" through "FOR9", and "CAT1" through "CAT9". (Cf. Chunks. Cf. 
Group LIST. Cf. Group PROP.) For clarity, these universal chunk names may not be FORM type IDs, either. 

Part 5, below, talks about grouping FORMs into LISTs and CATs. They let you group a bunch of FORMs 
but don't impose any particular meaning or constraints on the grouping. Read on. 
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Composite FORMs 

A FORM chunk Inside a FORM is a full-fledged data section. This means you can build a composite object 
Ike a multi-frame animation sequence from available picture FORMs and sound effect FORMs. You can 
insert additional chunks with information like frame rate and frame count. 

Using composite FORMs, you leverage on existing programs that create and edit the component FORMs 
Those editors may. even look into your composite object to copy out its type of component, although it'll 
be the rare program that's fancy enough to do that. Such editors are rjgi allowed to replace their 
component objects within your composite object. That's because the IFF standard lets you specify 
consistency requirements for the composite FORM such as maintaining a count or a directory of the 
components. Only programs that are written to uphold the rules of your FORM type should create or 
modify such FORMs. 

Therefore, in designing a program that creates composite objects, you are strongly requested to provide a 
facility for your users to import and export the nested FORMs. Import and export could move the data 
through a clipboard or a file. 

Here are several existing FORM types and rules for defining new ones. 

FTXT 

An FTXT data section contains text with character formatting information like fonts and faces. It has no 
paragraph or document formatting information like margins and page headers. FORM FTXT is well matched 
to the text representation in Amiga's Intuition environment. See the supplemental document 'FTXT' IFF 
Formatted Text. 

ILBM 

"ILBM" is an Interleaved BjtMap image with color map; a machine-independent format for raster images. 
FORM ILBM is the standard image file format for the Commodore-Amiga computer and is useful in other 
environments, too. See the supplemental document "ILBM' ]££ Interleaved Bitmap . 

PICS 

The data chunk inside a "PICS" data section has ID "PICT" and holds a QuickDraw picture. Issue: Allow 
more than one PICT in a PICS? See Inside Macintosh chapter "QuickDraw" for details on PICTs and how to 
create and display them on the Macintosh computer. 

The onfy standard property for PICS is "XY", an optional property that indicates the position of the PICT 
relative to "the big picture". The contents of an XY is a QuickDraw Point. 

Note: PICT may be limited to Macintosh use, in which case there'll be another format for structured 
graphics in other environments. 

Other Macintosh Resource Types 

Some other Macintosh resource types could be adopted for use within IFF files; perhaps MWRT, ICN, 
ICN#,andSTR#. 
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Issue: Consider the candidates and reserve some more IDs. 

Designing New Data Sections 

Supplemental documents win define additional object types. A supplement needs to specify the object's 
purpose, its FORM type ID, the IDs and formats of standard local chunks, and rules for generating and 
interpreting the data. It's a good idea to supply typedefs and an example source program that accesses the 
new object. See "ILBM" l£E Interleaved fijimaa for a good example. 

Anyone can pick a new FORM type ID but should reserve it with Electronic Arts at their earliest 
convenience. [Issue: EA contact person? Hand this off to another organization?] While decentralized 
format definitions and extensions are possible in IFF, our preference is to get design consensus by 
committee, implement a program to read and write it, perhaps tune the format, and then publish the format 
with example code. Some organization should remain in charge of answering questions and coordinating 
extensions to the format. 

If it becomes necessary to revise the design of some data section, its FORM type ID will serve as a version 
number (Cf. Type IDs). E.g. a revised "VDEO" data section could be called "VDE1". But try to get by with 
compatible revisions within the existing FORM type. 

In a new FORM type, the rules for primitive data types and word-alignment (Cf. Primftive Data Types) may 
be overriden for the contents of its local chunks— but not for the chunk structure itself—if your 
documentation spells out the deviations. If machine-specific type variants are needed, e.g. to store vast 
numbers of integers in reverse bit order, then outline the conversion algorithm and indicate the variant 
inside each file, perhaps via different FORM types. Needless to say, variations should be minimized. 

in designing a FORM type, encapsulate all the data that other programs will need to interpret your files. 
E.g. a raster graphics image should specify the image size even if your program always uses 320 x 200 
pixels x 3 bitplanes. Receiving programs are then empowered to append or clip the image rectangle, to 
add or drop bitplanes, etc. This enables a joi more compatibility. 

Separate the central data (like musical notes) from more specialized information (like note beams) so 
simpler programs can extract the central parts during read-in. Leave room for expansion so other programs 
can squeeze in new kinds of information (like lyrics). And remember to keep the property chunks 
manageably short— let's say s 256 bytes. 

When designing a data object, try to strfce a good tradeoff between a super-general format and a 
highly-specialized one. Fit the details to at least one particular need, for example a raster image might as 
well store pixels in the current machine's scan order. But add the kind of generality that makes it usable 
with foreseeable hardware and software. E.g. use a whole byte for each red, green, and blue color value 
even if this year's computer has only 4-bit video DACs. Think ahead and help other programs so long as 
the overhead is acceptable. E.g. run compress a raster by scan line rather than as a unit so future programs 
can swap images by scan line to and from secondary storage. 

Try to design a general purpose "least common multiple" format that encompasses the needs of many 
programs without getting too complicated. Let's coalesce our uses around a few such formats widely 
separated in the vast design space. Two factors make this flexbillty and simplicity practical. First, file 
storage space is getting very plentiful, so compaction is not a priority. Second, nearly any locally-performed 
data conversion work during file reading and writing will be cheap compared to the I/O time. 

It must be ok to copy a LIST or FORM or CAT intact, e.g. to incorporate It into a composite FORM. So any 
kind of internal references within a FORM must be relative references. They could be relative tothe start of 
the containing FORM, relative from the referencing chunk, or a sequence number into a collection. 
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With composite FORMs, you leverage on existing programs that create and edit the components. If you 
write a program that creates composite objects, pJsasfi provide a facility for your users to import and export 
the nested FORMs. The import and export functions may move data through a separate file or a clipboard. 

Finally, don't forget to specify all implied rules in detail. 
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5. LISTS, CATs, and Shared Properties 

Data often needs to be grouped together Ike a list of toons. Sometimes a trick Ike arranging little images 
into a big raster works, but generally they'll need to be structured as a first class group. The objects "LIST" 
and "CAT are IFF-unJversal mechanisms for this purpose. 

Property settings sometimes need to be shared over a list of similar objects. E.g. a list of icons may share 
onecotor map. LIST provides a means called "PROP" to do this. One purpose of a LIST is to define the 
scope of a PROP. A "CAT", on the other hand, is simply a concatenation of objects. 

Simpler programs may skip LISTs and PROPs altogether and just handle FORMS and CATs. All 
"fully-conforming" IFF programs also know about "CAT ", "LIST", and "PROP". Any program that reads a 
FORM inside a LIST must process shared PROPs to correctly interpret that FORM. 

Group CAT 
A CAT is just an untyped group of data objects. 

Structurally, a CAT is a chunk with chunk ID "CAT " containing a "contents type" ID followed by the nested 
objects. The cksize of each contained chunk is essentially a relative pointer to the next one. 

Cat ::- "CAT " #{ Content sType (FORM I LIST I CAT)* ) s 
Content sType ::- ID 

In reading a CAT, like any other chunk, programs must respect it's cksize as a virtual end-of-file for 
reading the nested objects even if they're malformed or truncated. 

The "contents type" following the CATs cksize indicates what kind of FORMs are inside. So a CAT of 
ILBMs would store "ILBM" there. It's just a hint. A CAT should have blank contents ID (" ") « » contains 
more than one kind of FORM. 

CAT defines only the format of the group. The group's msaoiOS & open to interpretation. This is like a list in 
LISP: the structure of cells is predefined but the meaning of the contents as. say, an association list 
depends on use. If you need a group with an enforced meaning (an "abstract data type" or Smalltalk 
"subclass"), some consistency constraints, or additional data chunks, use a composite FORM instead (Cf . 
Composite FORMs). 

Since a CAT just means a concatenation of objects. CATs are rarely nested. Programs should really merge 
CATs rather than nest them. 

Group LIST 

A LIST defines a group very much like CAT but it also gives a scope for PROPs (see below). And unlike 
CATs, LISTs should not be merged without understanding their contents. 

Structurally, a LIST is a chunk with ckiD "LIST" containing a "contents type" ID, optional shared properties, 
and the nested contents (FORMs. LISTs. and CATs). in that order. The cksize of each contained chunk 
is a relative pointer to the next one. A LIST is not an arbitrary linked list— 4he cells are simply concatenated. 

LIST ::- "LIST" #( ContentaType PROP* (FORM I LIST I CAT)* ) 
Content sType ::- ID 
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PROP chunks may appear In LISTs (not In FORMS or CATs). They supply shared properties for the FORMs 
in that LIST. This ability to elevate some property settings to shared status for a list of forms is useful for 
both indirection and compaction. E.g. a list of images with the same size and colors can share one "size' 
property and one "color map" property. Individual FORMs can override the shared settings. 

The contents of a PROP is like a FORM with no data chunks: 

PROP ::- "PROP" #{ FormType Property* } 

It means, "Here are the shared properties for FORM type <FormType>." 

A LIST may have at most one PROP of a FORM type, and all the PROPs must appear before any of the 
FORMs or nested LISTs and CATs. You can have subsequences of FORMs sharing properties by making 
each subsequence a LIST. 

Scoping: Think of property settings as variable bindings in nested blocks of a programming language. 
Where in C you could write: 



TEXT_FONT text_font - Courier; 

FileO; { 

TEXT FONT text font - TintesRoman ; 



/* program's global default 
/* shared setting 



{ 

TEXT_FONT text_font - Helvetica; /* local setting 

Print ("Hello ") ; 

) 



( 

Print ("there."); 

} 



/* uses font Helvetica 



/* uses font TintesRoman 



*/ 



*/ 
*/ 



An IFF file could contain: 

LIST ( 

PROP TEXT { 

FONT { TintesRoman } 
> 

FORM TEXT { 

FONT (Helvetica) 
CHRS (Hello ) 

) 

FORM TEXT ( 

CHRS (there.) 



) 



) 



/* shared setting 



/* local setting 

/* uses font Helvetica 



/* uses font TimesRoman 



*/ 
*/ 



*/ 



The shared property assignments selectively override the reader's global defaults, but only for FORMs 
within the group. A FORM'S own property assignments selectively override the global and group-supplied 
values. So when reading an IFF file, keep property settings on a stack. The/re designed to be small 
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enough to hold in main memory. 

Shared properties are semantteally equivalent to copying those properties into each of the nested FORMs 
right after their FORM type IDs. 

Properties for LIST 

Optional -properties for USF store the origin of the list's contents in a PROP chunk for the fake FORM 
type "LIST". They are the properties originating program "OPGM", processor family ^"OCPU computer 
type "OCMP", computer serial number or network address "OSN ", and user name "UNAM . In our 
imperfect world, these could be called upon to distinguish between unintended variations of a data format 
or to work around bugs in particular originating/receiving program pairs. Issue: Specify the format of these 
properties. 

A creation date could also be stored in a property but tors ask that file creating, editing, and transporting 
programs maintain the correct date in the local file system. Programs that move files between machine 
types are expected to copy across the creation dates. 
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6. Standard File Structure 

Fife Structure Overview 

An IFF file is just a single chunk of type FORM, LIST, or CAT. Therefore an IFF file can be recoonizsrf h u ». 
first 4 bytes: "FORM". "LIST", or "CAT ". Any file contents after the chunk's end are to be ignored 

Since an IFF file can be a group of objects, programs that read/write single objects can communicate to an 
extent with programs that read/Write groups. You're encouraged to write programs that handle all the 
objects in a LIST or CAT. A graphics editor, for example, could process a list of pictures as a muftiole oaae 
document, one page at a time. H y 

Programs should enforce IFF's syntactic rules when reading and writing files. This ensures reliable data 
transfer. The public domain IFF reader/writer subroutine package does this for you. A utility program 
"IFFCheck" is available that scans an IFF f He and checks it for conformance to IFFs syntactic rules 
IFFCheck also prints an outline of the chunks in the file, showing the cklD and cksize of each This is 
quite handy when building IFF programs. ; Example programs are also available to show details of readina 
and writing IFF files. 

A merge program "IFFJoin" will be available that logically appends IFF files into a single CAT group It 
"unwraps" each input file that is a CAT so that the combined file isnt nested CATs. 

If we need to revise the IFF standard, the three anchoring IDs will be used as "version numbers" That's 
why IDs "FORI" through "FOR9", "LIS1" through "LIS9", and "CAT1" through "CAT9" are reserved. 

IFF formats are designed for reasonable performance with floppy disks. We achieve considerable simplicity 
in the formats and programs by relying on the host file system rather than defining universal grouping 
structures like directories for LIST contents. On huge storage systems, IFF files could be leaf nodes in a 
file structure like a B-tree. Let's hope the host file system implements that for us! 

Thre are two kinds of IFF files: single purpose files and scrap files. They differ in the interpretation of 
multiple data objects and in the file's external type. 

Single Purpose Filet 

A single purpose IFF file is for normal "document" and "archive" storage. This is in contrast with "scrap files" 
(see below) and temporary backing storage (non-interchange files). 

The external file type (or filename extension, depending on the host file system) indicates the file's 
contents. It's generally the FORM type of the data contained, hence the restrictions on FORM type IDs. 

Programmers and users may pick an "intended use" type as the filename extension to make it easy to filter 
for the relevant files in a filename requestor. This is actually a "subclass" or "subtype" that conveniently 
separates files of the same FORM type that have different uses. Programs cannot demand conformity to its 
expected subtypes without overly restricting data interchange since they cannot know about the subtypes 
to be used by future programs that users will want to exchange data with. 

issue: How to generate 3-letter MS-DOS extensions from 4-letter FORM type IDs? 

Most single purpose files will be a single FORM (perhaps a composite FORM Ike a musical score 
containing nested FORMs like musical instrument descriptions). H it's a LIST or a CAT, programs should 
skip over unrecognized objects to read the recognized ones or the first recognized one. Then a program 
that can read a single purpose file can read something out of a "scrap file", too. 
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Scrap Files 

A "scrap file" Is for maximum interconnectivity in getting data between programs; the core of a clipboard 
function. Scrap files may have type "IFF " or filename extension ".IFP. 

A scrap file is typically a CAT containing alternate representations of the same basic information. Include as 
many alternatives as you can readily generate. This redundancy improves interconnectivity in situations 
where we can't make all programs read and write super-general formats, [Insjdfl Macintosh chapter "Scrap 
Manager".] E.g. a graphically-annotated musical score might be supplemented by a stripped down 4-voice 
melody and by a text (the lyrics). 

The originating program should write the alternate representations in order of "preference": most 
preferred (most comprehensive) type to least preferred (least comprehensive) type. A receiving program 
should either use the first appearing type that it understands or search for its own "preferred" type. 

A scrap file should have at most grjs alternative of any type. (A LIST of same type objects is ok as one of 
the alternatives.) But don't count on this when reading; ignore extra sections of a type. Then a program 
that reads scrap files can read something out of single purpose files. 

Rules for Reader Programs 

Here are some notes on building programs that read IFF files. If you use the standard IFF reader module 
"IFFR.C", many of these rules and details will be automatically handled. (See "Support Software" in 
Appendix A.) We recommend that you start from the example program "ShowlLBM.C". You should also 
read up on recursive descent parsers. [See, for example, Compiler Construction. An Advanced Course..] 

• The standard is very flexible so many programs can exchange data. This implies a program has to scan 
the file and react to what's actually there in whatever order it appears. An IFF reader program is a parser. 

• For interchange to really work, programs must be willing to do some conversion during read-In. If the data 
isn't exactly what you expect, say, the raster is smaller than those created by your program, then adjust it. 
Similarly, your program could crop a large picture, add or drop bitplanes, and create/discard a mask 
plane. The program should give up gracefully on data that it cant convert. 

• If it obesnl start with "FORM". "LIST", or "CAT ", it's not an IFF-85 file. 

• For any chunk you encounter, you must recognize its type ID to understand its contents. 

• For any FORM chunk you encounter, you must recognize its FORM type ID to understand the contained 
"local chunks". Even if you don't recognize the FORM type, you can still scan it for nested FORMs, 
LISTs, and CATs of interest. 

• Don't forget to skip the pad byte after every odd-length chunk. 

• Chunk types LIST, FORM, PROP, and CAT are generic groups. They always contain a subtype ID 
followed by chunks. 

• Readers ought to handle a CAT of FORMs in a file. You may treat the FORMs like document pages to 
sequence through or just use the first FORM. 

• Simpler IFF readers completely skip LISTs. "Fully IFF-conforming" readers are thoss that handle LISTs, 
even K just to read the first FORM from a file. If you dfl took into a LIST, you njust process shared 
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properties (in PROP chunks) properly. The idea is to get the correct data or none at an. 

• The nicest readers are willing to look into unrecognized FORMs for nested FORM types that they do 
recognize. For example, a musical score may contain nested instrument descriptions and an animation 
file may contain still pictures. 

Note to programmers: Processing PROP chunks is not simple! You'll need some background in 
interpreters with stack frames. If this is foreign to you, build programs that read/write only one FORM per 
file. For the more intrepid programmers, the next paragraph summarizes how to process LISTs and 
PROPs. See the general IFF reader module "IFFR.C" and the example program "ShowlLBM.C" for details. 

Allocate a stack frame for every LIST and FORM you encounter and initialize it by copying the stack frame 
of the parent LIST or FORM. At the top level, youll need a stack frame initialized to your program's global 
defaults. While reading each LIST or FORM, store all encountered properties into the current stack frame. 
In the example ShowlLBM, each stack frame has a place for a bitmap header property ILBM.BMHD and a 
color map property ILBM.CMAP. When you finally get to the ILBM's BODY chunk, use the property 
settings accumulated in the current stack frame. 

Rules for Writer Programs 

Here are some notes on buiding programs that write IFF files, which is much easier than reading them. If 
you use the standard IFF writer module "IFFW.C" (see "Support Software* in Appendix A), many of these 
rules and details will automatically be enforced. See the example program "Raw2ILBM.C". 

• An IFF file is a single FORM, LIST, or CAT chunk. 

• Any IFF-85 file must start with the 4 characters "FORM", "LIST" , or "CAT ", followed by a LONG cksize. 
There should be no data after the chunk end. 

• Chunk types LIST, FORM, PROP, and CAT are generic. They always contain a subtype ID followed by 
chunks. These three IDs are universally reserved, as are "LIS1" through "LIS9", "FORI" through 
"FOR9". "CAT1" through "CAT9", and" ". 

• Don't forget to write a pad byte after each odd-length chunk. 

• Four techniques for writing an IFF group: (1) build the data in a file mapped into virtual memory, (2) build 
the data in memory blocks and use block I/O, (3) stream write the data piecemeal and (don't forget!) 
random access back to set the group length count, and (4) make a preliminary pass to compute the 
length count then stream write the data. 

• Do not try to edit a file that you don't know how to create. Programs may look into a file and copy out 
nested FORMs of types that they recognize, but don't edit and replace the nested FORMs and don't 
add or remove them. That could make the containing structure inconsistent. You may write a new file 
containing items you copied (or copied and modified) from another IFF file, but don't copy structural 
parts you donl understand. 

• You must adhere to the syntax descriptions in Appendex A. E.g. PROPs may only appear inside LISTs. 
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Appendix A. Reference 

Type DeflnKlons 

The following C typedefs describe standard IFF structures. Declarations to use in practice will vary with the 
compiler For example, 68000 Lattice C produces efficient comparison code if we define ID as an 
"unsigned long". A macro "MakelD" builds these IDs at compile time. 

/* Standard IFF types. */ 

typedef unsigned char UBYTE; /* 8 bits unsigned */ 

typedef short WORD; /* 16 bits signed */ 

typedef unsigned short UWORD; /* 16 bits unsigned */ 

typedef long LONG; /* 32 bits signed */ 

typedef char ID [4]; 

typedef struct { 
ID ckID; 

LONG ckSize; /* sizeof (ckData) */ 

UBYTE ckDatat/* ckSize */]; 
} Chunk; 

/* ID typedef and builder for 68000 Lattice C. */ 

typedef LONG ID; 

♦define MakelD (a, b,c,d) ( (a)«24 I (b)«16 I (c)«8 I (d) ) 

/* Globally reserved IDs. */ 
♦define FORM MakelD CF', *0', 'R', 'M') 
♦define LIST MakeID( 'L', 'I', 'S', 'T') 
♦define PROP MakelDCP', 'R', 'O', 'P') 
♦define CAT MakelDCC', 'A', 'T', ' ') 
♦define FILLER MakelD ( ' ' , ' ' , ' • , ' * ) 

Syntax Definitions 

Here's a collection of the syntax definitions in this document. 

Chunk ::- ID ♦{ UBYTE* } [0] 
Property ::- Chunk 



FORM 



::- "FORM" ♦{ ForroType (LocalChunk I FORM I LIST I CAT)* } 
FormType : :■ ID 
LocalChunk ::- Property I Chunk 



CAT ::- "CAT " ♦{ ContentsType (FORM I LIST | CAT)* ) 

Content sType : :- ID 

LIST ::- "LIST" ♦{ ContentsType PROP* (FORM I LIST I CAT)* } 
PROP ::- "PROP" ♦{ FormType Property* ) 

In this extended regular expression notation, the token "♦" represents a cksize LONG count of the 
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following {braced} data bytes. Literal items are shown in "quotes", [square bracketed items] are optional, 
and ■*" means or more instances. A sometimes-needed pad byte is shown as " [ J ". 

Defined Chunk IDs 

This is a table of currently defined chunk IDs. Well also borrow some Macintosh IDs and data formats. 

Group chunk IDs 

FORM, LIST, PROP, CAT. 

fumca revision group chunk 10s 

FORI ... FOR9, LIS1 ... LIS9, CAT1 ... CAT9. 

FORM typ e IDs 

(The above group chunk IDs may not be used for FORM type IDs.) 

(Lower case letters and punctuation marks are forbidden in FORM type IDs.) 

PLBM, ILBM, ANBM, FTXT, PICS, USCR, GSCR, UVOX, GVOX, SFX, FNTR, FNTV, VDEO, PDEF. 

Data chunk IDs 
" ", TEXT, PICT. 

PROP LIST property IDs 

OPGM, OCPU. OCMP, OSN, UNAM. 

Formats for sampled sound, musical instrument, and musical score are currently being developed. 



Support Software 
These public domain C source programs are available for use in building I FF-compatible programs: 



IFF.H, IFFR.C, IFFW.C 

IFFCheck.C 

Packer.H, Packer.C, UnPacker.C 
ILBM.H, ILBMR.C, ILBMW.C 

ShowlLBM.C 
Raw2ILBM.C 



IFF reader and writer package. These modules handle many of 

the details of reliably reading and writing IFF files. 

This handy utility program scans an IFF file, checks that the 

contents are well formed, and prints an outline of the chunks. 

Run encoder and decoder used for ILBM files. 

Reader and writer support routines for raster image FORM ILBM. 

ILBMR calls IFFR and UnPacker. ILBMW calls IFFW and Packer. 

Example caller of IFFR and ILBMR modules. This 
Commodore-Amiga program reads and displays a FORM ILBM. 
Example ILBM writer program. As a demonstration, it reads a raw 
raster image file and writes the image as a FORM ILBM file. 
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Here's a box diagram for an example IFF file, a raster image FORM ILBM. This FORM contains a bitmap 
header property chunk BMHD, a color map property chunk CMAP, and a raster data chunk BODY. This 
particular raster is 320 x 200 pixels x 3 bit planes uncompressed. The "o" after the CMAP chunk 
represents a zero pad byte; included since the CMAP chunk has an odd length. The text to the right of the 
diagram shows the outline that would be printed by the IFFCheck utility program for this particular file. 



24070 



FORM 24070 


ILBM 


BMHD 20 


320, 200, 0, 0, 3, 0, 0, .- 




CMAP 21 


0, 0, 0; 32, 0, 0; 64, 0, 


— 





BODY 24000 f 


0, 0, o ._ 1 



FORM 24070 ILBM 



.BMHD 20 



.CMAP 21 



.BODY 24000 



This second diagram shows a LIST of two FORMs ILBM sharing a common BMHD property and a common 
CMAP property. Again, the text on the right is an outline a la IFFCheck. 



LIST 48114 ILBM 



.PROP 62 ILBM 



.BMHD 20 



LIST 






48114 


ILBM 


PROP 






62 


ILBM 


BMHD 






20 


320, 


200 


o, 


0, 3, 0, 0, ... 




CMAP 






21 


0, 0, 


0; 


32, 


0, 0; 64, 0, ... 





FORM 






24012 


ILBM 








| BODY 






24000 


1 o, o, 





- 




FORM 






24012 


ILBM 








BODY 






24000 


0, 0, 





... 


' 



.CMAP 21 



.FORM 24012 ILBM 



.BODY 24000 



.FORM 24012 ILBM 



.BODY 24000 
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Appendix B. Standards Committee 

The following people contrtouted to the design of this IFF standard: 

Bob "Kodiak* Bums, Commodore-Amiga 
R. J. Mical, Commodore-Amiga 
Jerry Morrison, Electronic Arts 
Greg Riker, Electronic Arts 
Steve Shaw, Electronic Arts 
Barry Walsh, Commodore-Amiga 
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Date: November 15, 1985 

From: Jerry Morrison, Electronic Arts 

Status: Released and in use 

1. Introduction 

"EA IFF 85" is Electronic Arts' standard for interchange format files. "ILBM" is the format for a 2 dimensional 
raster graphics image, specifically an Interleaved Wplane BjtMap image with color map. An ILBM is an IFF 
"data section" or "FORM type", which can be an IFF file or a part of one. (See the IFF reference.) 

An ILBM is an archival representation designed for three uses. First, a standalone image that specifies 
exactly how to display itself (resolution, size, color map, etc.). Second, an image intended to be merged 
into a bigger picture which has its own depth, color map, and so on. And third, an empty image with a color 
map selection or "palette" for a paint program. ILBM is also intended as a building block for composite IFF 
FORMs lice "animation sequence" and "structured graphics". Some uses of ILBM win be to preserve as 
much information as possible across disparate environments. Other uses will be to store data for a single 
program or highly cooperative programs while maintaining subtle details. So we're trying to accomplish a lot 
with this one format. 

This memo is the IFF supplement for FORM ILBM. Section 2 defines the purpose and format of property 
chunks bitmap header "BMHD", color map "CMAP", hotspot "GRAB", destination merge data "DEST", 
sprite information "SPRT", and Commodore Amiga viewport mode "CAMG". Section 3 defines the 
standard data chunk "BODY". These are the "standard" chunks. Section 4 defines the nonstandard color 
range data chunk "CRNG". Additional specialized chunks like texture pattern can be added later. The ILBM 
syntax is summarized in Appendix A as a regular expression and in Appendix B as a box diagram. 
Appendix C explains the optional run encoding scheme. Appendix D names the committee responsible 
for this FORM ILBM standard. 

Details of the raster layout are given in part 3, "Standard Data Chunk". Some elements are based on the 
Commodore Amiga hardware but generalized for use on other computers. An alternative to ILBM would be 
appropriate for computers with true color data in each pixel. 

Reference: 

"EA IFF 85" Standard for Interchange Format FJlfis describes the underlying conventions for all IFF files. 

Amiga™ is a trademark of Commodore-Amiga, Inc. 
Electronic Arts™ is a trademark of Electronic Arts. 
Macintosh™ ia a trademark licensed to Apple Computer, Inc. 
MacPaint™ is a trademark of Apple Computer, Inc. 
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2. Standard Properties 

The required property -BMHD" and any optional properties must appear before any "BODY" chunk. (Since 
an ILBM has only one BODY chunk, any following properties are superfluous.) Any of these properties 
may be shared over a LIST of FORMs IBLM by putting them in a PROP ILBM. (See the "EA IFF 85" memo.) 

BMHD 

The required property "BMHD" holds a BKMapHeader as defined in these C declarations and following 
documentation. It describes the dimensions and encoding of the image, including data necessary to 
understand the BODY chunk to follow. 

typedef UBYTE Masking; /* Choice of masking technique. */ 

♦define mskNone 

♦define mskHasMask 1 

♦define mskHasTransparentColor 2 
♦define makLasao 3 

typedef UBYTE Compression; /* Choice of compression algorithm applied to 

the rows of all source and mask planes. "cmpByteRunl" is the byte run 
encoding described in Appendix C. Do not compress across rows! */ 

♦define cmpNone 

♦define cmpByteRunl 1 

typedef struct ( 

UWORD w, h; /* raster width & height in pixels */ 

WORD x, y; /* pixel position for this image */ 

UBYTE nPlanes; /* ♦ source bitplanes */ 

Masking masking; 

Compression compression; 

UBYTE padl; /* unused; for consistency, put here */ 

UWORD tranaparentColor; /* transparent "color number" (sort of) */ 

UBYTE xAspect, yAspect; /* pixel aspect, a ratio width : height */ 

WORD pageWidth, pageHeight; /* source "page" size in pixels */ 

} BitMapHeader; 

Fields are filed in the order shown. The UBYTE fields are byte-packed. 

The fields w and h indicate the size of the image rectangle in pixels. Each row of the image is stored in an 
integral number of 1 6 bit words. The number of words per row is Ceiling( w/1 6). The fields x and y indicate 
the desired position of this image within the destination picture. Some reader programs may ignore x and 
y. A safe default for writing an ILBM is (x, y) - (0, 0). 

The number of source bitplanes in the BODY chunk (see below) is stored in nPlanes. An ILBM with a 
CMAP but no BODY and nPlanes - is the recommended way to store a color map. 

Note: Color numbers are color map index values formed by pixels in the destination bitmap, which may be 
deeper than np lanes if a DEST chunk calls for merging the image into a deeper image. 

The field masking indicates what kind of masking to to be used for this image. The value mskNone 
designates an opaque rectangular image. The value mskHasMask means that a mask plane is interleaved 
with the bitplanes in the BODY chunk (see below). The value mskHasTransparentColor indicates that 
pixels in the source planes matching transparentcolor are to be considered "transparent". (Actually, 
tranaparentColor isnl a "color number" since it's matched with numbers formed by the source bitmap 
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rather than the possibly deeper destination bitmap. Note that having a transparent color implies tanorlna 
one of the color registers. See CMAP, below.) The value mskLasso indicates the reader may construct a 
mask by lassoing the image as in MacPaint™. To do this, put a 1 pixel border of transparentcoior 
around the image rectangle. Then do a seed fill from this border. Filled pixels are to be transparent. 

Issue: Include in an appendix an algorithm for converting a transparent color to a mask plane, and maybe a 
lasso algorithm. 

A code indicating the kind of data compression used is stored in compression. Beware that using data 
compression makes your data unreadable by programs that don't implement the matching decompression 
algorithm. So we'll employ as few compression encodings as possible. The run encoding byteRuni is 
documented in Appendix C, below. 

The field padi is a pad byte and must be set to for consistency. This field could get used in the future. 

The transparentcoior specifies which bit pattern means "transparent". This only applies if masking is 
mskHasTransparentColor or mskLasso (see above). Otherwise, transparentcoior should be 0. 

The pixel aspect ratio is stored as a ratio in the two fields xAspect and yAspect . This may be used by 
programs to compensate for different aspects or to help interpret the fields w, h, x, y, pagewidth, and 
pageHeight, which are in units of pixels. The fraction xAspect/yAapect represents a pixel's 
width/height. It's recommended that your programs store proper fractions in BitMapHeaders, but aspect 
ratios can always be correctly compared with the the test 

xAspect«yDesiredAspect - yAspect -xDesiredAspect 

Typical values for aspect ratio are width : height -10:11 (Amiga 320 x 200 display) and 1 : 1 (Macintosh™). 

The size in pixels of the source "page" (any raster device) is stored in pagewidth and pageHeight, e g 
(320, 200) for a tow resolution Amiga display. This information might be used to scale an image or to 
automatically set the display format to suit the image. (The image can be larger than the page.) 

CMAP 

The optional (but encouraged) property "CMAP" stores color map data as triplets of red, green, and blue 
intensity values. The n color map entries ("color registers") are stored in the order through n-i, totaling 
3n bytes. Thus n is the ckSize/3. Normally, n would equal 2 nP1 * n «». 

A CMAP chunk contains a colorMap array as defined below. (These typedefs assume a C compiler that 
implements packed arrays of 3-byte elements.) 

typedef struct { 

UBYTE red, green, blue; /* color intensities 0..255 */ 

} ColorRegister; /* size - 3 bytes */ 

typedef ColorRegister ColorMap tn] ; /* size - 3n bytes */ 

The color components red, green, and blue represent fractional intensity values in the range through 
?i? 5 .!2? h8, WWte fe (255, 255, 255) and bteck '* <°» °- °>- w y°° r roach'"* has less color resolution, use 

JySf^ bte< sm each field ^ °° readln < or teft on ^'"O) and assign it to (from) a field in a local 
packed format Ifce color4, below. This achieves automatic conversion of images across environments 
with different color resolutions. On reading an ILBM, use defaults If the color map is absent or has fewer 
color registers than you need. Ignore any extra color registers. 
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The example type Color4 represents the format of a color register in working memory of an Amiga 
computer, which has 4 bit video DACs. (The " : 4" tells the C compiler to pack the field into 4 bits.) 



typedef struct { 
unsigned padl 
j color4; I* Amiga RAM format. Mq£, filed. */ 



unsigned pad! :4, red :4, green :4, blue :4; 



Remember that every chunk must be padded to an even length, so a color map with an odd number of 
entries would be followed by a byte, not included in the cksize. 

GRAB 

The optional property "GRAB" locates a "handle" or "hotspot" of the image relative to Hs upper left corner, 
e.g. when used as a mouse cursor or a "paint brush". A GRAB chunk contains a Point2D. 

typedef struct { 

WORD x, y; /* relative coordinates (pixels) */ 
} Point2D; 

DEST 

The optional property "DEST is a way to say how to scatter zero or more source bitplanes into a deeper 
destination image. Some readers may ignore DEST. 

The contents of a DEST chunk is DestMerge structure: 

typedef struct { 

UBYTE depth; /* # bitplanes in the original source */ 

UBYTE padl; /* unused; for consistency put here */ 

UWORD planePick;' /* how to scatter source bitplanes into destination */ 

UWORD planeOnOff; /* default bitplane data for planePick */ 

UWORD planeMask; /* selects which bitplanes to store into */ 
} DestMerge ; 

The low order depth number of bits in planePick, planeOnOf f , and planeMask correspond 
one-to-one with destination bitplanes. Bit with bitplane 0, etc. (Any higher order bits should be ignored.) 
"1 " bits in planePick mean "put the next source bitplane into this bitplane", so the number of "1 " bits 
should equal nPianes. "0" bits mean "put the corresponding bit from planeOnOf f into this bitplane". Bits 
in planeMask gate writing to the destination bitplane: "1" bits mean "write to this bitplane" while "0" bits 
mean "leave this bitplane alone". The normal case (with no DEST property) is equivalent to planePick - 
planeMask - 2 nPlanM - 1. 

Remember that color numbers are formed by pixels in the destination bitmap (depth planes deep) not in 
the source bitmap (nPianes planes deep). 

SPRT 

The presence of an "SPRT" chunk indicates that this image is intended as a sprite. It's up to the reader 
program to actually make it a sprite, if even possible, and to use or overrule the sprite precedence data 
inside the SPRT chunk: 

typedef UWORD SpritePrecedence; /* relative precedence, is the highest */ 
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Precedence is the highest, denoting a sprite that is foremost. 

Creating a sprite may imply other setup. E.g. a 2 plane Amiga sprite would have transparentcoior - 
Color registers 1 , 2, and 3 In the CMAP would be stored into the correct hardware color registers for the 
hardware sprite number used, while CMAP color register would be ignored. 

CAMG 

A "CAMG" chunk is specifically for the Commodore Amiga computer. It stores a long Viewport mode". 
This lets you specify Amiga display modes like "dual playfiekf and "hold and modify". 
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3. Standard Data Chunk 

Raster Layout 

Raster scan proceeds left-to-right (increasing X) across scan lines, then top-to-bottom (increasing Y) down 
columns of scan lines. The coordinate system is in units of pixels, where (0,0) is the upper left comer. 

The raster is typically organized as bitplanes in memory. The corresponding bits from each plane, taken 
together, make up an index into the color map which gives a color value for that pixel. The first bHplane, 
plane 0, is the tow order bit of these color indexes. 

A scan line is made of one "row" f rem each bHplane. A row is one planes' bits for one scan line, but padded 
out to a word (2 byte) boundary (not necessarily the first word boundary). Within each row, successive 
bytes are displayed in order and the most significant bit of each byte is displayed first. 

A "mask" is an optional "plane" of data the same size (w, h) as a bitplane. It tells how to "cut out" part of the 
image when painting it onto another image."One" bits in the mask mean "copy the corresponding pixel to 
the destination" while "zero" mask bits mean "leave this destination pixel atone". In other words, "zero" bits 
designate transparent pixels. 

The rows of the different bitplanes and mask are interleaved in the file (see below). This localizes all the 
information pertinent to each scan line. It makes it much easier to transform the data while reading it to 
adjust the image size or depth. It also makes it possible to scroll a big image by swapping rows directly from 
the file without random-accessing to all the bitplanes. 

BODY 

The source raster is stored in a "BODY" chunk. This one chunk holds all bitplanes and the optional mask, 
interleaved by row. 

The BitMapHeader, in a BMHD property chunk, specifies the raster's dimensions w, h, and nPlanes. It also 
holds the masking field which indicates if there is a mask plane and the compression field which 
indicates the compression algorithm used. This information is needed to interpret the BODY chunk, so the 
BMHD chunk must appear first. While reading an ILBM's BODY, a program may convert the image to 
another size by filling (with transparentColor) or clipping. 

The BODY'S content is a concatenation of scan lines. Each scan line is a concatenation of one row of data 
from each plane in order through nPianes-i followed by one row from the mask (if masking - 
hasMask ). If the BitMapHeader field compression is cmpNone, all h rows are exactly Ceiling(w/1 6) words 
wide. Otherwise, every row is compressed according to the specified algorithm and their stored widths 
depend on the data compression. 

Reader programs that require fewer bitplanes than appear in a particular ILBM file can combine planes or 
drop the high-order (later) planes. Similarly, they may add bitplanes and/or discard the mask plane. 

Do ool compress across rows and dont forget to compress the mask just like the bitplanes. Remember to 
pad any BODY chunk that contains an odd number of bytes. 
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4. Nonstandard Data Chunk 

The following data chunk was defined after various programs began using FORM ILBM so it's a 
"nonstandard" chunk. That means there's some slight chance of name collisions. 

CRNG 

A "CRNG" chunk contains "color register range" information. Ifs useful for identifying a contiguous range 
of color registers for color cycling. There can be zero or more CRNG chunks in an ILBM, but all should 
appear before the BODY chunk. 

typedef struct { 

WORD padl; /* reserved for future use; store here */ 

WORD rate; /* color cycle rate */ 

WORD active; /* nonzero means cycle the colors */ 

UBYTE low, high; /* lower and upper color registers selected */ 
} CRange; 

The fields low and high indicate the range of color registers (color numbers) selected by this CRange. 

The field active indicates whether color cycling is on or off. Zero means off. 

The field rate determines the speed at which the colors will step when color cycling is on. The units are 
such that a rate of 60 steps per second is represented as 2 14 - 16384. Slower rates can be obtained by 
linear scaling: for 30 steps/second, rate - 8192; for 1 step/second, rate -16384/60 - 273. 
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Appendix A. ILBM Regular Expression 

Here's a regular expression summary of the FORM ILBM syntax. This could be an IFF file or a part of one. 

ILBM ::- "FORM" #{ "ILBM" BMHD [CMAP] [GRAB] [DEST] [SPRT] [CAMG] 

CRNG* [BODY] } 



BMHD ::- "BMHD" #{ BitMapHeader 

CMAP ::- "CMAP" #{ (red green blue)* 

GRAB ::- "GRAB" #{ Point2D 

DEST ::- "DEST" #{ DestMerge 

SPRT : :- "SPRT" #{ SpritePrecendence 

CAMG ::- "CAMG" #{ LONG 

CRNG ::- "CRNG" #{ CRange 

BODY ::- "BODY" #{ UBYTE* 



[0] 



[0] 



The token "*" represents a cksize LONG count of the following {braced) data bytes. E.g. a BMHD's "#" 
should equal sizeof (BitMapHeader) . Literal strings are shown in "quotes", [square bracket items] are 
optional, and "*" means or more repetitions. A sometimes-needed pad byte is shown as " [ o ] ". 

The property chunks (BMHD, CMAP, GRAB, DEST, SPRT, and CAMG) and any CRNG data chunks may 
actually be in any order but all must appear before the BODY chunk since ILBM readers usually stop as 
soon as they read the BODY. If any of the 6 property chunks are missing, default values are "inherited" 
from any shared properties (if the ILBM appears inside an IFF LIST with PROPs) or from the reader 
program's defaults. If any property appears more than once, the last occurrence before the BODY is the 
one that counts since that's the one that modifies the BODY. 
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Appendix B. ILBM Box Diagram 



Commodore-Amiga 



Here's a box diagram for a simple example: an uncompressed image 320 x 200 pixels x 3 bitplanes. The 
text to the right of the diagram shows the outline that would be printed by the IFFCheck utility program for 
this particular fie. 



FORM 24070 ILBM 



.BMHD 20 



24070 



FORM 




24070 






ILBM 


BMHD 




20 






320, 200, 


0, 


0, 3, 0, 


0, 


.- 




CMAP 




21 






0, 0, 0; 


32, 


0, 0; 64, 


0, 


... 













BODY 




24000 




1 


0, 0, .. 








-J 



.CMAP 21 



..BODY 24000 



The "0" after the CMAP chunk is a pad byte. 
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Appendix C. ByteRunl Run Encoding 

The run encoding scheme byteRuni Is best described by psuedo code for the decoder Unpacker (called 
UnPackBlts in the Macintosh™ toolbox): 

UnPacJcer : 

LOOP until produced the desired number of bytes 
Read the next source byte into n 
SELECT n FROM 

[0.. 127] -> copy the next n+1 bytes literally 
[-1..-127] -> replicate the next byte -n+1 times 
-128 -> noop 
ENDCASE; 
END LOOP; 

In the Inverse routine Packer, it's best to encode a 2 byte repeat run as a replicate run BiSSSL when 
preceded and followed by a literal run, In which case It's best to merge the three into one literal run. Always 
encode 3 byte repeats as replicate runs. 

Remember that each row of each scan line of a raster is separately packed. 
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Appendix D. Standards Committee 

The following people contrtxrted to the design of this FORM IUBM standard: 

Bob "Kodak" Bums, Commodore-Amiga 
R. J. Mfcal, Commodore-Amiga 
Jerry Morrison, Electronic Arts 
Greg Riker, Electronic Arts 
Steve Shaw, Electronic Arts 
Dan SBva, Electronic Arts 
Barry Walsh, Commodore-Amiga 
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Date: November 15, 1985 

From: Steve Shaw and Jerry Morrison, Electronic Arts and Bob Kodiak Burns, Commodore-Amiga 

Status: Draft 2.6 

DRAFT DRAFT DRAFT DRAFT DRAFT 



1. Introduction 

This memo Is the IFF supplement for FORM FTXT. An FTXT is an IFF "data section" or "FORM 
type"— which can be an IFF file or a part of one— containing a stream of text plus optional formatting 
information."EA IFF 85" is Electronic Arts' standard for interchange format files. (See the IFF reference.) 

An FTXT is an archival and interchange representation designed for three uses. The simplest use is for a 
"console device" or "glass teletype" (the minimal 2-D text layout means): a stream of "graphic" ("printable") 
characters plus positioning characters "space" ("SP") and line terminator ("LF")- This * not Intended for 
cursor movements on a screen although it does not conflict with standard cursor-moving characters. The 
second use is text that has explicit formatting information (or "looks") such as font family and size, typeface, 
etc. The third use is as the lowest layer of a structured document that also has "inherited" styles to implicitly 
control character looks. For that use, FORMs FTXT would be embedded within a future document FORM 
type. The beauty of FTXT is that these three uses are interchangeable, that is, a program written for one 
purpose can read and write the others' files. So a word processor does not have to write a separate plain 
text file to communicate with other programs. 

Text is stored in one or more "CHRS" chunks inside an FTXT. Each CHRS contains a stream of 8-bit text 
compatible with ISO and ANSI data interchange standards. FTXT uses just the central character set from 
the ISO/ANSI standards. (These two standards are henceforth called "ISO/ANSI" as in "see the ISO/ANSI 
reference".) 

Since it's possible to extract just the text portions from future document FORM types, programs can 
exchange data without having to save both plain text and formatted text representations. 

Character looks are stored as embedded control sequences within CHRS chunks. This document 
specifies which class of control sequences to use: the CSI group. This document does not yet specify 
their meanings, e.g. which one means "turn on italic face". Consult ISO/ANSI. 

Section 2 defines the chunk types character stream "CHRS" and font specifier "FONS". These are the 
"standard" chunks. Specialized chunks for private or future needs can be added later. Section 3 outlines 
an FTXT reader program that strips a document down to plain unformatted text. Appendix A is a code table 
for the 8-bit ISO/ANSI character set used here. Appendix B is an example FTXT shown as a box diagram. 
Appendix C is a racetrack diagram of the syntax of ISO/ANSI control sequences. 
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Reference: 

Amiga™ is a trademark of Commodore-Amiga, Inc. 

Electronic Arts™ is a trademark of Electronic Arts. 

IFF: !EA 1EE AS! Standard lor Interchange Format Has describes the underlying conventions for all IFF 
files. 

ISO/ANSI: ISCYDIS 2422,2 and ANSI X3.64-1979 . International Organization for Standardization (ISO) 
and American National Standards Institute (ANSI) data-interchange standards. The relevant parts of these 
two standards documents are identical. ISO standard 2022 is also relevant. 
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2. Standard Data and Property Chunks 

The main contents of a FORM FTXT is in its character stream "CHRS" chunks. Formatting property chunks 
may also appear. The only formatting property yet defined is TONS", a font specifier. A FORM FTXT with 
no CHRS represents an empty text stream. A FORM FTXT may contain nested IFF FORMs, USTs, or 
CATs, aJthough a "stripping" reader (see section 3) will Ignore them. 

Character Set 

FORM FTXT uses the core of the 8-bit character set defined by the ISO/ANSI standards cited at the start of 
this document. (See Appendix A for a character code table.) This character set is divided into two "graphic- 
groups plus two "control" groups. Eight of the control characters begin ISO/ANSI standard control 
sequences. (See "Control Sequences", below.) Most control sequences and control characters are 
reserved for future use and for compatibility with ISO/ANSI. Current reader programs should skip them. 

• CO is the group of control characters in the range NUL (hex 0) through hex 1 F. Of these, only LF (hex 
0A) and ESC (hex 1B) are significant. ESC begins a control sequence. LF is the line terminator, 
meaning "go to the first horizontal position of the next line". All other CO characters are not used. In 
particular, CR (hex 0D) is not recognized as a line terminator. 

• GO is the group of graphic characters in the range hex 20 through hex 7F. SP (hex 20) is the space 
character. DEL (hex 7F) is the delete character which is not used. The rest are the standard ASCII 
printable characters "l" (hex 21 ) through "-" (hex 7E). 

• C1 is the group of extended control characters in the range hex 80 through hex 9F. Some of these 
begin control sequences. The control sequence starting with CSI (hex 98) is used for FTXT 
formatting. All other control sequences and C1 control characters are unused. 

• Q1 is the group of extended graphic characters in the range NBSP (hex A0) through f (hex FF). It is 
one of the alternate graphic groups proposed for ISO/ANSI standardization. 

Control Sequences 

Eight of the control characters begin ISO/ANSI standard "control sequences" (or "escape sequences"). 
These sequences are described below and diagrammed in Appendix C. 



60 


:- (SP through DEL) 




Gl : 


:- (NBSP through "JD 




ESC-Seq 


:- ESC (SP through V)* CO" 


through w - 


ShiftToG2 : 


:• SS2 GO 




ShiftToG3 : 


:- SS3 60 




CSI-Seq 


:- CSI (SP through •?")* P8" 


through *- 


DCS-Seq 


:- (DCS I OSC I PM I APC) (SP 


through w - 



') 

' | Gl)* ST 

"ESC-Seq" is the control sequence ESC (hex 1 B). followed by zero or more characters in the range SP 
through T (hex 20 through hex 2F), followed by a character in the range "0" through "-" (hex 30 through 
hex 7E). These sequences are reserved for future use and should be skipped by current FTXT reader 
programs. 

SS2 (hex 8E) and SS3 (hex 8F) shift the single following GO character into yet-to-be-defined graphic sets 
G2 and G3, respectively. These sequences should not be used until the character sets G2 and G3 are 
standardized. A reader may simply skip the SS2 or SS3 (taking the following character as a corresponding 
GO character) or replace the two-character sequence with a character like T to mean "absent". 

FTXT uses "CSI-Seq" control sequences to store character formatting (font selection by number, type 
face, and text size) and perhaps layout information (position and rotation). "CSI-Seq" control sequences 
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start with CSI (the "control sequence Introducer", hex 9B). Syntactically, the sequence includes zero or 
more characters in the range SP through T (hex 20 through hex 3F) and a concluding character in the 
range "@" through "-" (hex 40 through hex 7E). These sequences may be skipped by a minimal FTXT 
reader, i.e. one that ignores formatting information. 

Note: A future FTXT standardization document will explain the uses of CSI-Seq sequences for setting 
character face (light weight vs. medium vs. bold, italic vs. upright, height, pitch, position, and rotation). For 
now, consult the ISO/ ANSI references. 

"DCS-Seq" is the control sequences starting with DCS (hex 90), OSC (hex 90), PM (hex 9E), or APC (hex 
9F), followed by zero or more characters each of which is in the range SP through "-' (hex 20 through hex 
7E) or else a G1 character, and terminated by an ST (hex 9C). These sequences are reserved for future 
use and should be skipped by current FTXT reader programs. 

Data Chunk CHRS 

A CHRS chunk contains a sequence of 8-bit characters abiding by the ISO/ANSI standards cited at the 
start of this document. This includes the character set and control sequences as described above and 
summarized in Appendicies A and C. 

A FORM FTXT may contain any number of CHRS chunks. Taken together, they represent a single stream 
of textual information. That is, the contents of CHRS chunks are effectively concatenated except that (1) . 
each control sequence must be completely within a single CHRS chunk, and (2) any formatting property 
chunks appearing between two CHRS chunks affects the formatting of the latter chunk's text. Any 
formatting settings set by control sequences inside a CHRS carry over to the next CHRS in the same 
FORM FTXT. All formatting properties stop at the end of the FORM since IFF specifies that adjacent 
FORMs are independent of each other (although not independent of any properties inherited from an 
enclosing LIST or FORM). 

Property Chunk FONS 

The optional property "FONS" holds a FontSpedfier as defined in the C declaration below, it assignee a 
font to a numbered "font register" so it can be referenced by number within subsequent CHRS chunks. 
(This function is not provided within the ISO and ANSI standards.) The font specifier gives both a name 
and a description for the font so the recipient program can do font substitution. 

By default, CHRS text uses font 1 until it selects another font. A minimal text reader always uses font 1 . If 
font 1 hasnl been specified, the reader may use the local system font as font 1 . 

typedef struct { 

UBYTE id; /* through 9 is a font id number referenced by an SGR 

control sequence selective parameter of 10 through 19. 

Other values are reserved for future standardization. */ 
UBYTE padl; /* reserved for future use; store here */ 

UBYTE proportional; /* proportional font? - unknown, 1 - no, 2 - yes */ 
UBYTE serif; /* serif font? - unknown, 1 - no, 2 - yes */ 
char named; /* A NUL-terrainated string naming the preferred font. */ 
} Font Specifier; 

Fields are filed in the order shown. The UBYTE fields are byte-packed (2 per 16-bit word). The field padl is 
reserved for future standardization. Programs should store there for now. 

The field proportional indicates if the desired font is proportional width as opposed to fixed width. The 
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field serif indicates if the desired font Is serif as opposed to sans serif. [Issue: Discuss font substitution!] 

Future Properties 

New ootional Drooerty chunks may be defined in the future to store additional formatting information. They 
wi7t^Ko^i^nV^rmattini not encoded in standard ISO/ANSI control seances and for 
Xtm^klmS!^ structured documents. Text orientation might be one example. 

Positioning Units 

Unless otherwise specified, position and size units used in FTXT formatting properties and control 
sanies aTeln SSoSSs% decipoints/inch). This is ANSI/ISO Positioning UnH t Model (PUM) 2 While 
a metric standard might be nice, decipoints allow the existing USA typographic units to be encoded 
easity. e.g. "12 points" is "120 decipoints". 
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3. FTXT Stripper 

An FTXT reader program can read the text and ignore all formatting and structural information in a 
document FORM that uses FORMs FTXT for the leaf nodes. This amounts to stripping a document down 
to a stream of plain text. It would do this by skipping over all chunks except FTXT.CHRS (CHRS chunks 
found inside a FORM FTXT) and within the FTXT.CHRS chunks skipping all control characters and control 
sequences. (Appendix C diagrams this text scanner.) It may also read FTXT.FONS chunks to find a 
description for font 1. 

Here's a Pascal-ish program for an FTXT stripper. Given a FORM (a document of some kind), it scans for all 
FTXT.CHRS chunks. This would likely be applied to the first FORM in an IFF file. 

PROCEDURE ReadFORM4CHRS(); (Read an IFF FORM for FTXT.CHRS chunks \ 
BEGIN 

IF the FORM'S subtype - "FTXT" 
THEN ReadFTXT4CHRS() 

ELSE WHILE something left to read in the FORM DO BEGIN 
read the next chunk header; 
CASE the chunk's ID OF 

"LIST", "CAT ": ReadCAT4CHRS ( ) ; 
"FORM": ReadFORM4CHRS(); 
OTHERWISE skip the chunk's body; 
END 
END 
END; 

{Read a LIST or CAT for all FTXT.CHRS chunks.) 
PROCEDURE ReadCAT4CHRS () ; 
BEGIN 

WHILE something left to read in the LIST or CAT DO BEGIN 
read the next chunk header; 
CASE the chunk's ID OF 

"LIST", "CAT *: ReadCAT4CHRS() ; 

"FORM" : ReadFORM4CHRS ( ) ; 

"PROP": IF we're reading a LIST AND the PROP'S subtype - "FTXT" 

THEN read the PROP for "FONS" chunks; 
OTHERWISE error— malformed IFF file; 
END 
END 
END; 

PROCEDURE ReadFTXT4CHRS(); {Read a FORM FTXT for CHRS chunks.) 
BEGIN 

WHILE something left to read in the FORM FTXT DO BEGIN 
read the next chunk header; 
CASE the chunk's ID OF 
"CHRS": ReadCHRSO; 
"FONS": BEGIN 

read the chunk's contents into a FontSpecifier variable; 
IF the font specifier's id - 1 THEN use this font; 
END; 
OTHERWISE skip the chunk's body; 
END 
END 
END; 
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{Read an FTXT.CHRS. Skip all control sequences and unused control chars.} 
PROCEDURE ReadCHRSO; 
BEGIN 

WHILE something left to read in the CHRS chunk DO 
CASE read the next character OF 
LF: start a new output line; 
ESC: SkipControl ( [ • '..'/']/ ['0'. .'-']); 
IN (• '..'-'], IN (NBSP..'y']: output the character; 
SS2, SS3: ; {Just handle the following GO character directly, 

ignoring the shift to G2 or G3 . ) 
CSI: SkipControKf '..'?'], t'9'. •'-']); 

DCS, OSC, PM, APC: SkipControl ([ ' '..'-•] + [NBSP. . 'y'], [ST]); 
END 
END; 

{Skip a control sequence of the format (rSet)* (tSet) , i.e. any number of 

characters in the set rSet followed by a character in the set tSet . } 
PROCEDURE SkipControl (rSet, tSet) ; 
VAR c: CHAR; 
BEGIN 
REPEAT c :- read the next character 

UNTIL c NOT IN rSet; 
IF c NOT IN tSet 

THEN put character c back into the input stream; 
END 

The following program is an optimized version of the above routines ReadFORM4CHRS and 
ReadCAT4CHRS for the case where you're ignoring fonts as well as formatting. It takes advantage of certain 
facts of the IFF format to read a document FORM and its nested FORMs, LISTs, and CATs without a stack. 
In other words, it's a hack that ignores all fonts and faces to cheaply get to the plain text of the document. 

{Cheap scan of an IFF FORM for FTXT.CHRS chunks.} 
PROCEDURE ScanF0RM4CHRS ( ) ; 
BEGIN 

IF the document FORM'S subtype - "FTXT" 
THEN ReadFTXT4CHRS() 

ELSE WHILE something left to read in the FORM DO BEGIN 
read the next chunk header; 
IF it's a group chunk (LIST, FORM, PROP, or CAT) 

THEN read its subtype ID; 
CASE the chunk's ID OF 

"LIST", "CAT ":; {NOTE: See explanation below.*) 
"FORM": IF this FORM'S subtype - "FTXT" THEN ReadFTXT4CHRS() 

ELSE; {NOTE: See explanation below.*) 

OTHERWISE skip the chunk's body; 
END 
END 
END; 

•Note: This implementation is subtle. After reading a group header other than FORM FTXT it just continues 
reading. This amounts to reading all the chunks inside that group as » they weren't nested in a group. 
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Appendix A: Character Code Table 

This table corresponds to the ISCVDIS 6429.2 and ANSI X3.64-1979 8-bit character set standards. Only 
the core character set of those standards is used in FTXT. 

Two G1 characters aren't defined in the standards and are shown as dark gray entries in this table. Light 
gray shading denotes control characters. (DEL is a control character although it belongs to the graphic 
group GO.) The following five rare G1 characters are left blank in the table below due to limitations of 
available fonts: hex A8, DO, DE, FO, and FE. 

ISO/DIS 6429.2 and ANSI X3. 64-1979 Character Coda Table 
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•NBSP" is a "non-breaking space" 
"SHY" is a "soft hyphen" 
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Appendix B. FTXT Example 

Here's a box diagram lor a simple example: The quick brown fox jumped.Four score and seven", written in 
a proportional serif fort named "Roman". 

"form 




Four score and seven 
The "0" after the first CHRS chunk is a pad byte. 
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Appendix C. ISO/ANSI Control Sequences 

This is a racetrack dagram of the ISO/ANSI characters and control sequences as used in FTXT CHRS 



chunks. 



tno tonrrinstor __ 

._ — H 




through Q +S l^|~~l/ 



Of the various control sequences, only CSI-Seq is used for FTXT character formatting information. The 
others are reserved for future use and for compatibility with ISO/ANSI standards. Certain character 
sequences are syntactically malformed, e.g. CSI followed by a CO, C1 , or G1 character. Writer programs 
should not generate reserved or malformed sequences and reader programs should skip them. 

Consult the ISO/ANSI standards for the meaning of the CSI-Seq control sequences. 

The two character set shifts SS2 and SS3 may be used when the graphic character groups G2 and G3 
become standardized. 
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Appendix I 
Printer-Dependent Source Code 

This appendix contains the printer-dependent source code for the following printers: 

hpplus - Hewlett Packard LaserJet Plus 
okimate20 - Okidata 
epson - Epson X-80 series 
diabloc - Diablo C-150 



In addition, this appendix includes macros. i, which is required in order to assemble any of 
the ".asm" files. 

These files are intended to aid developers in creating their own custom printer drivers that 
can be added to the DEVS: directory on an AmigaDOS disk. The documentation that 
explains the contents of these files is in the "Printer Device" chapter of the Amiga ROM 
Kernel manual. 



I 



H 

in 

H 
J 



i 

i 



I 

fa. 



^ e , s . 



B 






I 









-1-1 " 



It 
0. 



o 

f-l 

•a 

•o 



IN 

o 

CO 

.H 

P) 



« « « « 

» to 01 « 55 w 



uuuuuu 



8 k k8 

£ £ £ £ 




« i/> r» «0 e M 



(tT*H «U«*-I 



C<HHP^ WH<H\ 



o o mo s3h 



jo SflaB'H-H 6 » w 

n k. Sw S f * aJe S 

SbiODQIlH cJT >-) Z Q 



r1i-lf-l<U 3i-l3 >, u 
4J fi-H VHU 

— i — i — < n,«M fl\M bog 
+j *j +> ITC'Hja 3j3 9 

mo p o 00 o 
A) 4J *J V JJ « 4J 
1.1.1.03333^3 

a Q, a. u « « « « a. « 



bl to to 

HUM 



558 
S8S 

8 o "Sv.* 

8* 8* 8 c o 



BSBCEESCSCB 

£££££££££££ 

to to to to to to to to to <w tO 

SBSBSSSESSS 



CBBCSCeCSC 

tototocototototototo 

BBSBBSSBBS 



E S ,•**« B 
CO W O W €0 



s s s s s 



b> b) bib) 

M U U1M 



CJ O sac 

s>s Ba 

i M 

■si in 

c o* 0* 

« o 
0*o 

I* 

o 
so » * * » 8 ifl 

ChfOBSBS i-H 

totor*r*r*r*-*to 
woKSKhuro 
o *yto to to to 

S B B S B S 



„ _ 0*0* 0*0* 
EC *~» o rt -H •* 

« w w w w t« 

uuuuuu 



•a 5-a 

U V U u u 

« ffl rH rH r-4 rH 

WlJUUUU 



cs 



00 






e »E s » » 
we ant E 
<•> ^ ro <*> ^ p» 

l*> p* <*>(*> p. p» 
- (f) (o 



A>«1 

<•> 

•p » 
m m 

e ex 

<S 4J -HE 

<*> (*) p» 
nlnh 
— © <o 






I 



o 

•a 

■o 



00 



o 

•a 

! 

I 

1 






■v ■>* 



I 
I 



u 
o 

i-a 
is 



4 I 



it II 



asa IS 

- ." -a* 

ill 




•s ssl-a 



U t. I. u — « 

* * 8 8 §o 

O OHH 



b) « bi « bl'bi 



W -H M -H U W 



3993 

cu 04 cu a* 



39 

So. 



00 cS 88 

Oil O O -H -4 

L U CO. i-l fH 

u o if if a a 

10 M U U ^-< -< 

UIIIX -P +J 

lllla 8.1. 

(9 |0 « 10 -i 



(/ E 

an * 

go - *© » 
6 C^ S H rH S 

nnnoon 

I B E E E E 



CEESSSEEE 



E E E E E S E 



C E E S C S 



ppppppCPf; ppppppp PPPPPC £££££££ 

tototototototototo to^to^toto^toto_to_ to^to^to^to^to^to^ to^to^to^to^to^to^to^ 

B S fc E B B B B B 



B B S B B s 



S B S S S B S 



-1-2- 



to 

■H 

in 



♦ * 

e i— i 

<N »-i 



I 






? 



L 10 

3 H 

rl 
if 



o 

■a 

■H 

•o 



ST 



« ii 



fit fe-8 

■H -H 41 



II II II II 



,9000 


IU>M<U<M .» 


<H<M(M<H^ 


DO SlB w 


JJ 4J 4J V C 


3 3 3 3 C 


3 3 3 3 
O U 



o 

a 



o 

■8 

•o 
in 

s 

H 

oo 

H 
H 

«r 



I 



o 

•H 

I 

I 



S 9 

•9 : 

■H « 

•o « 



u 
o 

12 



SSI 

8 V. L 

Sao. 
"II 



HI 

i-l r-t »H 

JJJ 



! 



10 



S 1 

rH 

is 
b 






£ & 



e 



3 



!<2 



5 

h. 



V. 



• © 

ii ?g 




SI- o. 

Mb *H 2 
l|SI 111 I 



-1-3- 



>s 



1 



f 

!■•■ 



1* 



I! 
ii 

ss 

33 

• • 



10 



1? 



II 



is 



> 5 o a c 
^ i V i II 



3 3 



Tl ?! xxxxs 

©3 r-t a* 3 « 3 <3 3 



II II II II o 




v. 



in 

II 



0. 

ST 



a, iJ a. S 5 £ .5 5 •§ £ 






O 

■a 



1ft 



in 

a 

a> 

H 




3 h S 






C iH 



*J3 



o,o 



tss 'b§S 

5 5 






«S 



4 "8. 



5 






r ? 



3 a 



(0 A CD CD 03 CD tB 

; Ha.,aa.,aais 



a. 



o 
I 



1 



I 8 
5 3 



O. c z t t r 



. '-. I 8 

Hit f i ft 



3 

1" 



1 ^W 



o 



°r. 



bububububububuEububu 
UUUMUUWUWU 

sessssssss 




I Still 

11 ygw* 



iJ .JO.JJ 



8 



8,.«i 



-1-4- 






9 



I 



o 

■a 



O 

•a 

•o 



S 1 







111 55s 

5 q o titid 







il 



: II 

I i 



z 

? 



hi bi Eu [u f * f f * i hi | 



? 
IB 



i a a $ 



I 

8 

I 



© MM .8 +J § C 88 ! 
Q «* "-■ " -' - = - • 



■p +J 3 c a O P 




say ^yy'a^^y'yyyH'y'yyyy 



a 
■p 






0. 



4J 

5 
•9 

•a 



<D 

en 



m 

o 

o 

H 




3 I 

1 3 



» 



IB 



D 

o 



IB I 



-1-5- 



^ 



CD 

H 

m 




ooooo 

$555$ 



a 
& 



o 

3 

U 




1 

4-> 

5. 



■9 - if? 

fl If 



8 

•S 



41 

Si"" 



.« 



\ 



6 k* 

111 

j, g. 



M w * 

Sit 



V 



•^*. 






■ -<n e m IS 



^s+* _ 'V •» u * •» + 
«-» I t- c> . •* ^ t^ <*> 

SS9«$S.2HHH_ 

« « M « « ■ ,0 M M >H ~~ 
> 3 3« HH Q 

sw u ••88 s p- o 8 8 a 



w m •* 



gifts' 3 

o •*£«■ " 5- 01 - 

b 3 8 I. 
9 4J 4J C 4J C -H 
4J -H ••<»<-< «J 
CUl. 0> U Ol 
•H X LZLO 

U . J5.M fi, U ■>* 



^Sff 



•^«6. 



MM »5 

H 



II. U. w 








S 1 



5 5 



JL 





•H 

■o 



R 



-1-6- 



u 



o 

■o 
m 

S 

as 
m 



* 



8" 



?i 




Q, w l - J p* 

♦ O *< rl <U 

1** 



II 



Si 



9 9^« 

8"! If- 

N3 all 



o o o 
*% + + ♦ 

»" <N || || || M || || \ 

«M « 

i— I+ + + + + +C 

W M M l-t W H H f. ,M »H 

t« iimm :\\ 

•HJ KKKPinnP! S 

V,, ««««««« i— «(— it— i 

l« •* + + + + + + + lit 

<MM<M <U<U<UW<M<U<M * * * 

^BSTSSSSSIS* ft}; 

•o La* a a aa.fi. a M £,&&* 

<s a, i «h i i i i i i i c c c 

I! s 



If***- 




04 fit 



* 



S 1 



> u 



4 ^ 



-1-7- 



lufutulubuhiUjIutu 



lulu EESH'5 f 5 , io*)'i >>woiO< j2BBw« 








^g^g** 
JalJ i. l-a-a 



£ £ !a !s »3 , B<-y "9 <S * -y -y t. 8 i. i. u w 

\ O ffl ffl QH a OMI JH ffiffii-H^^^HrHrHO 

h 8 6,4 J os *j m h J u nouuuuui 




SrcccccEJCCC 
f*OOOOOOOi-lr-1f-. 

tnoooooooooo 



r s 



He t 
L *•*.<**. oeooooooooo 



► rjr* rt n o w w w w w w rt o <ocor>r>f0fopocop*f0 




cccccBcce 



oororoooooroo 
ssccccsrcc 



C C C C K 

0<NU8Q 
CO CO CO CO CO 

ro co co co o 
o o o o 



K K C B C 



r r cs etc essences s 

fcfcpfcfc&F: p p p £ & £ £ £ P 

cn_ co_ co_ co_ co_ co_ <o_ oroonrtfjfOrt co 



s c s s s r * 



SSSCCCSC 






•y 



8 




iqzq 

BS OS w 



J 



<•> _ * «"• 



tu S 

55 n 




SSSo to nun 



I 

■H 






88 

1 - 11 

* ,,.,55888* 

(8 ~H-HUL<M«*-l<M.Q 



I 



T 8og' 



•CO 

HHUij 



u u u k " 

B>8> s * 8 « s? 
39 •o-o^^ ( 



2ii S §J3£ S 8 t ?388SS illff 



o _<" 

C "M 
4J *J 



bb55 
"Sbb 

O 10 19 
(B GO H W 







(0 ci fl w w p) n p r 

C0COC0COCOCOC0r , '*r fc 

oooooooenco 



ft S m t* c* R m 



o o o o o © ©, 



cj s "n 'x 
p» r*- co co co co 

^ ^ CO CO CO ro 

co co o o e o 



co * o * 

ro co o co 

CO CO CO CO 



-1-8 - 



1 



* 
I 



& 8 

o • 



0> 



5 

II 



.rnr-i O 

; *s t/> *-^ •» 

1 <7»0>v x 






a 



'III! 



£. 

w 



5 
n 




9£~« s |~« u ? 



,! 



5 * 



e o tn o — • 

Hill 

HHHHrt U 

> > > > > « 






<i <S d 4 d « « 

T3 T3 T3 ig x) t5 xj 





If 



HI 

HHH 

111 

• •• 



i 



8 jS 



5 s 5 s ^ 
9 •-• 6 ■-» '-' 

HQ,8<iLH E 

• JTOh 3 u 3 

•h g« > o oo, 

« « « 



sp 






SP 

o 

I 



Si 



t 



8 



w 

£ 



!8 



Elssl 

*> V *> 






5 

II 
X 



sf;- 

3 ♦ 
O X 



HI V 

43 



r-i 

>3 



x 

li 

♦ 
+ 

X 



KB 
ST! 

9? 



•5 ..ffS) •. 

•0- U c- 

iff \\ 




r^M -H • 



-1-9- 



I 3 

0< b 



? I 

% is. 



C C C ^1 S 

•4 ^ -H • <H *4 U 

9 « 10 C W 3 <S 

JJ Q U U B 

3 § %s «• 

O { Q M w J> 

833839 "0 .. . , 

SKCCSC c c O < 



1 Biggie b t 






ft 1 

°1 




? 1 B i 333388 1 i i| 



I : 



S 



aaaa 




is 






:8 

2t! 



«■ rt 






3 



I 



jut] 












I 4J 4J 4J 

3 3 3 

3 3b 





? i 



- 1-10 - 



I 



!f 



5 



k. 



-lift 
"15 



1! 



- *J 

C H 



0$ > 

8 3 8 t) 



| 1 ||| | 

CO M HHH M 



| 



af- 



•p 3 c a 



111 



5 fS 






"8 1 

t £ 

X bjbibj(uUibututu O 



t 



. Si 



52 

MM 



vJsI$.. BI »'5'5.s 



55" 
£6: 



!JH, 



1 a £ "« 

Sell. ' ' 1™ 

seas' aaaasa'iiiiiiiiiia^iiii 






5 






E jji 

9*1-85 



S"» 



8 P 

o < 



» 



:9< 



ifl 



i 

^ 



l-l 

8 
41 >« 



00 O X 



ii aaa 



§ 



II 



O 1-4 

lu 






SB 



•,°i 



- i-n - 






*V** A 



J 



a 



it 

S3- 



1 



• * % x % c 



g 



a 

1 

4 






1 



0^^ 



Is 



a.. 

'J * _ >3 . 



•N> 



I 

_ .4aa 
■w ja > 
a x 4J 



kT 



« 3 a 3 a 3 c 

« «H »H r4 r-4 fl U 



I o x J) 8 

j«gj9 few 



« * 



ll 



HH|I 

83* 



4J 4J 4J 
B B U I 






a 



i 1 

„ _ _ „ .5 • »!»> o 



5 



- _• a « f» - » 

15 ..is e i u i^. "3 

ooh 8JI.S, < 5, o <-i 

5 v. tfl <m J* 8 /TtH (TiJ <m 

•— X 31 Q.4J i >»l H 

H« OOljrcQ4JO I * 

1*5 iml It 



* 1 
8^3 



I 





■^•M 3 « j_ V. 5 

.. * I- <0 „** 

I i 



3 S 



8. 



4 






V 

M 



CO 



1») 



h. 



- 1-12 - 






c 



\ 



in 
oo 



Pill 



tH M i— ir— i 

- J 8SBS 

M M X 

II II M CO « 

hmS'bb'! 

mm 

9 9 3 2 2 2? 

«M <M «M «M *W «M lM 

noiSfflnOf 





•h p— . c a a n u L 






Q QQ QQQ © 
0, O, 0, 0.0.0. C 









n 



•8 



- 1-13 - 



\ 



££ 
UK 

W M 






« 

4J 



I 



co 





o 

00 

H 



i 

■H 









il >?ri 



j2 3.cm5-h-h c on 



00000000000 



C S S B B 



B B S Z B 



-v» -%,-2 
« C « O 

t-l t-4 .H C0C 

g g g § >. s b 

o o>v>C , >S ^ 

JJ JJ JJ JJ -H JJ -H JS« 

I. >. I. O 4J -H V ffl 
a Q. a JJ.firH4Jrt.JJ 

• V rt k. m 1-1 



5 3 3 3 3 r-i 3 
» N R fl 4 4 Old 

z ««««««««« 

»%% 

*-"*-"*^e t c c s c c 

CSEBCKCCCS 




IS 



W n f« r) in 

e o m o o 

S S S C S 



iJl 



* 

\u^ 



•"•9 8* 

5-a_0>__» 4J <• JJ J3 -H 4J 1 






l?SiS4u 



iH JJ S 

3 et h <fi h 3 nituuuuui 



s t s x c r en ccxcccxcc 
c c ccccc cccccsccc 



Oj 



a 

f 

I 



r> 

o 

00 

H 




1 * * iii'ii* 
i 

* 



4 o 

t-j ,flu • »o o 

c xo as <n o r * 

•a 





- 1-14 - 



0. 




I— f 

I 



1/1 

8 



a 



I 
I 



I 



S 



ill 



SgS 

(9 CU (9 







lb 

1 



if 
a 

o •*« ■ » 

': lut 

I o o o 
I o o o 
i o o 

l*)HO (J 

o o e <n 
^o o o 

S O rH O 

i— 'in m m 

o o /© 
U^r ^ 

5* II r 
II .-.II 

355i) 

-I ^ -H -) 

5555 



»•• M.UM00U0 



SSSSSSIS 





W 











*-^ 






5 




ii 


^ 




1 


r— i 
X 

1 


"8 




f 
IT 


8- 

ft 


t 


5 




? 


? 


i 

r-l 




a 

* .. 


4J 

■H 




I 


ii 


f> : : 


C M <N 

til ll 

CU nr-i 


cm 


(—i 

■2, 


encas. 
again 
far [7] 


encas. 
fer [14 
fer [18 


• * 

h 


s 

1 

o 


*W 


S D>3 


U<M^4 


u »* 


<M 


<2 


222 


£2 


1 
1 

« 


■w 


( ou 


ffl 4J 4J 


4J 


SB-;- 

V 

X 


P 

i 


->pd_Pr 
outpu 
outpu 


51 

5,0 

i 


^■* 


o 


Q 


a 


\ 





at 


a. 


£t 





a. 
o 



in 

8 




I 



rH>s 



- 1-15 - 



•I 

••A X S3 1-1 <Z C <« 

* 5 jj «T- i 



?*^J? 



.2 






5 



- E * 1 1 s as. b M g f r 

i &' &l s II a |,a 3 t *. 

--> " -"■ i 5 5 5 a. & ™ s ?. 8 " 

oojaasa oaoe JT <S + 

T if ig sjk- ?? «£!■♦ *!? e S k 

N. •• e>* •» «?'•* X el Hi! HJt flfl« QiH9« H<^m *» b <B 

•5E .5E . i i . HI J. | || I f| 



i r 



> e c«v g«0 c <« >-< «j m £ 93c c jd 3 3s c e <~-> h3 

ig « t. a — s a — i. a -i « •* • 5 ^eec a ? ^e s 2 a -. a u So 

S f I 6 6 ° h 8 b 

Rx 9 I F fit b 

HS glgS 



l 

Hi 
o 




•SiSiS 
a*u im 

3 If 

II 5 o 
♦ ♦ ♦ 



|ll ! ! 1 III 



5 1 n ss "M > ? ? ? ? 

'&£ 

I it H 111 1*11! 111! 111! III! IIII 11*1 II*' 



S ?i WW S Vhb-7 B«Hg iitfg lioo lira IfrS ?lffs 1 55 



I 



- 1-16 - 



t 



1 



GO 



1 

fa. 



CSC <H£ 



c s c c c c 



1 s 1 



5 



6 | 

(II M 



ii! 






ill! j 

w V w Q v > 

3 3 3 3 3 3 •o 



ft 1 






« 3 

si 
°, M I 






mm i 



a 

s 

I 

Q bu tu tu (u lu (u 

I II 



IHIUHJ 



S3 



o£ 



5 



• a w < x 



►J J J J J J 



5 



:8 

* f 



§ 



« 



_ o 
ffl -1 

W 4-1 

O.w, 



c 



! 



a. 



5 R 



* 



I § 



04 



ii.. 

s-"m e 

^»4 o 

ill 



i .hi 



£, 


^ 


h 

<u 
lu 


4T<u 


s 


§£ 



f if * 

•H >M PH 3 



rS S H| 



-1-17- 



0. 



■H 

5 
I 






1 



IT a£ a£ 



a 4 



I 



II II 11 



S 



iB 



I 



« i 






■U 

■H 

5 

r-l 

I 



oo 




Is 1 




o 

o 



|B 



J 



I. 

c o 



QJ5 



X a 
<u o 



[4 



cu 



g 

•H 
•P 

1 



' 8 
I 



I 



ffi (D 03 03 03 03 X 

a'a aa aaa 



! 

1-18- 






t 

I 



s 






§ £ 



S 1 



£ 



I 



I 8 









1= 



H 
10 



I J 
I 1 



111 






e. 



*hWW 



1 



I 1 



I | Si 



i m g | 

M HHH M R 



I IjiI. i 

i "ill I 

seaa 

zS 5 I B i-Sfc 

o m a c s 5t X Sob 

Sm w 4J *j 3 c ail IB,* 

to m CHilJ in o iofc 

_' » «£ 7< c T Art 1> M eneoSJl 

* > B a II I ISSOOHBHHH nin 



•y 



- 1-19 - 






<7* 




SOU 

.o V. .0 



5 



&» 

i:^» 



-*-*ISS?, 



H II II II II « 

- || i— if— ii— ir—11— »*— yJX 

H«— i HNW^inifl o 
Wnt ♦ ♦ t ♦ ♦ 

!il*ffffff » 

I J <M IW <H <U <U <U <W <U 

) u cL<S m o ffl tfi (Q da * 



k 



; i > 

sa..° t 

m,-. ffl 

To 2 l u o « 

B 5 « 2 *« w <m H 
8 onsuio 3 3 
Bhi<) o a uj a +j 

C o dS J5 5 A 

^3/1 ffl 4J 4J 



A A A A A A A 

I I I I I I I V 



<HHO|i 



i iiKSKL i III L i 

AAAAAAA*9fB ffl *■""* TD 3 A *■"" 



-H fi~ 



Ik 5 



i-ja 






11 



1 




« ffl ffl ffl ffl > > 

« 9 3 S 3 •8 •§ 



: -8 -8-8-S -8 -8 

« 3 3 3 3 3 3 

« <H r-( i-t i-4 i-i pH 

« 

: 555555 



S 
Jl 

> 






k 



o 

•H 
rH 

i -. 

8 I 






SJl 



i « 









(3 it ri|j « «-. C --. c --. en a x 
E si5 ww 1 " « t. a fl ? « . H^ 



a* ^f7eH2"5ii|55i j.5 

u 5 So ^S M«Sfi«.H4i^S' M i 

°^ SS^|||i5^i|i| ft '3 



•=-? 




s 
5 

rH 

J 

I 



o. ii Z 5 5 '• i 



- 8i 



! Q XV <M<M <U SOU 

IS -H ■H -I -H -H ASIA 



- 1-20 - 



8. 



J 



in 



s 



li 



M W rH 

CO CO 



w woj « toes 

uuuuuu 



w w 




« m r* eo o 



» u > at 

<N cn eN «n 

£ £ £ £ 



\ 



M U MM 



53 3 x: 
£Kg. Ei 



JgSgg S § Ht>« 3 s 



>\* « « 



8 « 8» 83888 



wifflO as 

~ f>. «H t> 



UUUUUV o 



onn h 



!h£h 



8*|gS 



S W 1 3 <U.H C"iM 



BE c I <« <3 a C c 



000 SttS« o * § 

CI « It <M 1~l 1-1*1 S k 

c c g o u •h'S o 

V £ *h JJ w * 
M -H «H QjCc-l TJ»M IOC 

L U I Lh I.U -P," 

a a a oooooo 
V !T try *j u u u <o +j 

kUL03333iH3 
Q.CUQUM C8 IS eg eg 0,(0 



H«* bbbbbbbbcxe 

OOP) nnWWWWWMWDfO 
sec seeeeetrter 



BSBSBBBSES 



esse 



S B S * S 




J a. H A H 3 u 



■a 



ir> : 



S S \B B S 



B B S C S S S 

co o <n <o f) o <•> 



B B B S C S S 



<8 «H fl rH *H 

k is k * krt 
tow u o u 



B Qt 

r^r-eoPR 

flnwoooi 






eg 
I 



CN 

5 



* 






O 
• 




°« « e >j 



"W M 



« H * 

CO CN N* fN 5 CN 

to CO 05 to » 85 

MUUUIUU 



CO ^" CN 
CO fN ^" CN W CN ' 



w 



.!"S 



11 



«h "WOO 



65 -<■ H L L <w <w 



ci eg ■o 

-4-H 3 



§ii 



S 



A 4 
en ij 



•"r-t e t o 



, CO CO I 



_ ) CO CO c 
CO O CO CO CO I 

e C o o o ■ 



I I B B S S 



is s s 



43* * • • 

y y w"rt" w"P 
w to eg eg ct eg 

W W -< -H -< -< 



HH * 

88 a 




S o S oil's, 

BlJJkb 

•H -H W «H rH fH 

so 8 9 



000 

llll v 

U U b >.^< 

g g 9 S So 

11!J» 



o 5 
eg co 

H 



to a to eg 

w -h m ■ 



cu & a< cu 



So >« 

bis** 

t. 

h-§-§ 



•letw 



a b ig 



c c 

Op 

-> CO 



r* CO 

ejec 

C «N CO <N r» «N 1. . . 
QCNCOCNH(N(OrO 

C o o o e e e e 
\s c c £ c c c 



ninB 



B fe * « MM 

r» p« p> p> co co 
S S KS co co 

CO CO CO CO o o 
S C C C B C 



JO M 
CO * o • 

CO CO CO CO 



- 1-21 - 



i 



2 



* 



3 



g g 

•H <» •» o « •• 

I H «-» II II «■* 

o ! ST ^S|T 

l-Hgg o -H g U 

■* \\ <-< 5 ? v rt B 3 ....__ 

* ffi « 84 -^ mI< i 14 9 <— * 




,« 



,! 






» g I 




(MlM<M<M<M 



! 



J 



0. 



! 

8 



! 



1 
| 

! 



o j N 

'• S 3 

3 8. | 

I : Id 



"X "V 



iH 

b 
1 



< 



£ 




J- •Sum 

& ii £ " ♦* 



.V is § b b 

• ii 8 <s 8 * •* 




f 
a 

& o 



s: 

S.x. 



5 2 




5! :: 



" 5 _ "ii "ii "ii "ii li 

B £ m ♦ + ♦♦♦ 

9 • ♦ ♦♦♦♦•« 
a g&8868&£ 

« 8 (I <H »4 "M <H W I 
>v £ <u <M <M <U <M > 



t- o o 



- 1-22 - 



I 

a. 



& 



« 



I 







i 



' R 11$ J I lis 






OB 



om 



« 



p< 



ir 



II 



31 



f af a£ 



iu 



°iG 



Si 

41 



o*w 



8 

•H 



1 



03 03 00 03 

a'a aa 



i 



i 



3 3 

M Q 






I 



5 

1 I * 



fi 5 



* 



« * C HI 



III III u 

113112 8 8 

Itiiil > J. 

388388 *S x( 

E E E E E E EC 



33 S 



I *< 



*-■ a o "o Q999QQ SS ** «-n«< 

§ H ? gggygy gy I ggg 

« J* W M HHHHHH HH M BSfi 



,s; 



S 1 J 



- 1-23 - 



1,1^,^^1,1, 



SSS9S! 



i,© e o o e o 

J J J ij J J 

aa'aa'a'a 




5 * 

0. » 



•p 

•H 

c 



i 



S 1 



4 



3 



HI 



1-1 



£ 



3 



? 



lift 5 

"\9 I 



el 



> 

3 3 3 *o 

CSC c 



www w 



iii pi i 

i B i dim 8 

Q« CO M M M H-l M 



i 



a 
■y 






•H Q, 9 O B «H 

WW 



i (u (u tu lu lu 



f 



s 



8S 
§ as 



388J2 

tifc,Qfi£HP«»a 5 



o 

I? 






I XX 1J1JJJ1J SQOOX iJJXX JJJJ m 



«1 






5 



5 

O 

9 



3 



fe> 



00 03 X 






t *$ *$ 



I ik 



I o I o lu 






5 

5 




I 



8 I 



IS 



- 1-24 - 



^ 



i 

On 






* 



a 



A S- 




9 3 o 9 tl 

V V V V * 

lllll 

(H i-t .H rH »-4 

.iJiiai 



ft) .* I— » 

saw 

E338 





W -H -( -H 

suss 



* ? 



>s 



! 



•885 



il 



(9 

4J 










« 

o 

IN 



8 > 



I 8 



£ ** 



8- 



t 



«n3 
1*0 




5 



^■■5 

2.2.2? ~£- S " 
888£ Si?. 



x 



* 

u 



.1 






IK 



"MM - 

■^ _ - °< ■"■' 

■i n ^ -h a « 



4-1 r-l S •-< 




5 



V..M 



a. 



S 1 



4 



« 



O 



- 1-25 - 



:\ 



S>*5SS 

|| » "C^ 

<M <M P» H —»>fl 

5 is in 

jj u v vo -h m 

•h 4J o> £ in 
> «j £ a E u 
£ c -3 i _l 
J 13 2 __ V •> 
•a a « 5.-U 
cu* iv A <fl 

II II -H <— 



K 3« 



! 



E. 




»t-t 

2 



bS 






it" 



its 

*4 4J 



I-5S 



i 3 ^ 



ho 2 2 1 

<s II II II II • 

II i-^r— ii M |*H 
•H p» m * ~ 
♦ ♦ ♦ ♦ 

1. u u u u . 
■p -p -p v -p i. 

£■'&£' fi*£" to 

3 3 3 3 3-1 

(U <U (M <M <U L 
0Q m3 EU 03 Qj ^5 

-4 -H -H -I -4 * 





,11* 

'tin 

4J -P •-< 

.P-.P-" 1 

■M «M 

3 3 0< 
£,&* 
<U <M »w 

w m * 

55 - 




nS ggggg 




* ~ 



0* 



If) 

s 



« 

I! 

3 « 

* r 1 

O 
I- 



5 



kid. 
alt 

5- 



n n n ii ii (jS* 

~~;; ssij 

0^ Cft Cft Cft 0* «4 

« • O 5 

3X$ H 5*2 

ill 8 S -gHI 

b b u b b 8 w 



Sb 



♦ ♦ ♦ 

Si, ||f 

I— | + <M <M *M 4J 



4J ..0\0 

(5 u o ■>-' 

♦ <M ♦ ■' * 

b X b <D I. 

go *j *j 

"frvS "&A «T 
3 9 3 

+ i*) + <*> ♦ « 

UfElfbJL 

uSuSu o 

i i| if s 

•S .E.JJ b -S r 




55> 



3 2 3 

A A O 



l ft.. H 



CJS 





- 1-26 - 



Types of Supported Printers 

The available printers that are supported for the Amiga include both whole character 
(daisy wheel) and dot matrix (wire, ink jet, and laser) types. As with printer 
capabilities, printer prices range widely, from just over $200 to over $3500. In 
general, the dot matrix printers are capable of graphics output, while "whole 
character" printers are not. 

Every attempt has been made to support a given feature on each printer that, itself, 
supports that feature. For example, the daisy wheel printers lack the capability to 
produce characters such as enlarged or italic print. Similarly, the dot matrix printers 
often lack such features as proportional spacing. 

None of the supported printers currently supports all of the available features. (The 
Epson JX-80 and the HP LaserJet Plus come closest.) Whenever the system 
requests an unsupported feature, the PRT: handler simply ignores that request. (The 
"generic" printer driver currently ignores. all feature requests.) 

If two or more features are each available for a particular printer, they should be 
usable in combination. For example, Bold-Italic-Underscore is a possible style for 
many printers. 

If your printer is not among those supported for the Amiga, you have two options. If 
your printer shares a number of common features with one of the supported printers, 
you can select that printer in Preferences. Keep in mind, however, that one or more 
of the chosen printer's features might not produce a similar effect on your printer. 

Your second option is to select "Custom" from the list of supported printers in 
Preferences and "Generic" as the custom printer name. You can then construct a 
custom printer driver following the directions in the Amiga ROM Kernel Manual. 

The following table lists the printers that are currently supported for the Amiga 
grouped according to print technology. ' 
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Table 1: Printers Supported on the Amiga 



Dot Matrix (Wire), Parallel 
Manufacturer Model 



Commodore 


CBM MPS 1000 


Epson 


Epson JX-80 


Epson 


Epson MX-80, FX-80, ... 


Okimate 


Okimate 20 


Daisy Wheel, Parallel 




Manufacturer 


Model 


Alphacom 


Alphapro 101 


Brother 


HR-15XL 


Diablo 


630 (Some models are serial) 


Diablo 


Advantage D25 


Qume 


LetterPro 20 


Ink Jet, Parallel 




Manufacturer 


Model 


Diablo 


C-150 


Laser, Serial 




Manufacturer 


Model 


Hewlett Packard 


Laser Jet 


Hewlett Packard 


Laser Jet Plus 


Other (Custom) 




Manufacturer 


Model 



Limited support is offered for a "generic" printer. 
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Table 2: Printer Functions Supported on the Amiga 

Legend: 

ISO indicates that the sequence has been defined by the International Standards 
Organization. This is also very similar to ANSII x3.64. 

DEC indicates a control sequence defined by Digital Equipment Corperation. 
indicates a sequence unique to Amiga. 



• • • 
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Printer 


name: 




Alphacom 
AlphaProlOl 


Brother 


Diablo 630 
HR-15XL 


Code* 


Description 


Defii 

ISO 


ned 






c 


Reset 


X 


X 


X 


#1 


Initialize 


••* 


X 


X 


X 


D 


Line feed 


ISO 


X 


X 


X 


E 


Line feed, CR 


ISO 


X 


X 


X 


M 


Reverse line feed 


ISO 


X 


X 


X 


[Om 


Normal char, set 


ISO 


X 


X 


X 


[3m 


Italics on 


ISO 








[23m 


Italics off 


ISO 








[4m 


Underline on 


ISO 


X 


X 


X 


[24m 


Underline off 


ISO 


X 


X 


X 


[lm 


Boldface on 


ISO 


X 


X 


X 


[22m 


Boldface off 


ISO 


X 


X 


X 


[nm 


Set foreground color 












(n m {30-39}) 


ISO 




X 




[fim 


Set background color 
(n m {40-49}) 


ISO 








[Ow 


Normal pitch 


DEC 


X 


X 


X 


[2w 


Elite on 


DEC 


X 


X 


X 


[lw 


Elite off 


DEC 


X 


X 


X 


[4w 


Condensed fine on 


DEC 


X 


X 


X 


[3w 


Condensed off 


DEC 


X 


X 


X 


[6w 


Enlarged on 


DEC 








[5w 


Enlarged off 


DEC 








[6"z 


Shadow print on 


DEC 


X 


X 


X 


[5"z 


Shadow print off 


DEC 


X 


X 


X 


[4"z 


Doublestrike on 


DEC 


X 


X 


X 


[3"z 


Doublestrike off 


DEC 


X 


X 


X 


[2"z 


NLQ on •* 


DEC 








[1-z 


NLQ off " 


DEC 









Entire escape sequence consists of ESC (ASCII 27) plus indicated code. 
* Near Letter Quality 
** Sequence unique to Amiga 
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Printer name: 
Code Description 



[2v Superscript on 

[lv Superscript off 

[4v Subscript on 

[3v Subscript off 

(Ov Normalize the line 

L Partial line up 

K Partial line down 



Alphacom 
AlphaProlOl 



Brother 



Diablo 630 
HR-15XL 



Defined 



so 
so 



X 
X 
X 
X 
X 
X 
X 



X 
X 
X 
X 
X 
X 
X 



X 
X 
X 
X 
X 
X 
X 



(B 

(R 

(K 

(A 

(E 

(H 

(Y 

(Z 

(J 

(6 

(C 



U.S. char. 
French " 
German " 
UK 

Danish I " 
Swedish " 
Italian 
Spanish ' 
Japanese 
Norwegian 
Danish II 



set 



DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
»•• 

DEC 

• •• 



[2p 
[IP 

[Op 

[n 
[5 
[7 
[6 
[0 
[3 
[1 



Proportional on 
Proportional off 
Proportional clear 
Set prop, offset (n) 
Auto left justify 
Auto right justify 
Auto full justify 
Justify off 
Letter space (justify) 
Word fill (auto center) 



••* 
••• 
••» 

ISO 
ISO 
ISO 
ISO 
ISO 
ISO 
ISO 



X 
X 
X 

X 
X 



X 
X 
X 
X 



X 
X 
X 



_[0z 1/8" line spacing 

[lz 1/6" line spacing 

[*t Set form length (n) 

(nq Perf skip (n>0) * 

[0q Perf skip off 



*•• 

DEC 

• •» 

• •• 



X 
X 
X 



X 
X 
X 



X 
X 
X 



•Paper perforation skip, n lines 
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Printer name: 



Code Description 



[Oz 1/8" line spacing 

[lz 1/6" line spacing 

[nt Set form length (n) 

[nq Perf skip (/i>0)' 

[Oq Perf skip off 





Alphacom 


Brother 


Diablo 630 




AlphaProlOl 




HR-15XL 


Defined 






••• 


X 


X 


X 


••• 


X 


X 


X 


DEC 


X 


X 


X 


••• 









#9 Left margin set 
#0 Right margin set 
#8 Top margin set 
#2 Bottom margin set 
[nl\n2x Top; Bottom margins 
[nl;n2$ Left; Right margins 
#3 Clear margins 



• •• 


X 


X 


X 


• •• 


X 


X 




• •• 


X 


X 


X 


• •• 


X 


■ X 


X 


DEC 








DEC 




X 


X 


• •• 




X 


X 


ISO 




X 


X 


ISO 




X 


X 


ISO 




X 


X 


ISO 




X 


X 


ISO 






X 


ISO 




X 




••• 




X 


X 


••• 




X 


X 



H Set horiz. tab 

J Set vert, tab 

[Og Clear horiz. tab 

[3g Clear all hor. tabs 

[lg Clear vert, tab 

[4g Clear all vert, tabs 

#4 Clear all h & v tabs 

#5 Set default tabs 

[n"x (Extended commands) 
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Prime 


r name: 




CBM 


Epson 


Epson 








MPS- 1000 


JX-80 


X-80 


Code 4 


1 Description 


Define* 

ISO 


i 






c 


Reset 


X 


X 


x 


#1 


Initialize 


••* 


X 


X 


x 


D 


Line feed 


ISO 


X 


X 


x 


E 


Line feed, CR 


ISO 


X 


X 


x 


M 


Reverse line feed 


ISO 




X 




[Om 


Normal char, set 


ISO 


X 


X 


x 


[3m 


Italics on 


ISO 




X 


x 


[23m 


Italics off 


ISO 




X 


x 


[4m 


Underline on 


ISO 


X 


X 


x 


[24m 


Underline off 


ISO 


X 


X 


x 


[lm 


Boldface on 


ISO 


X 


X 


x 


[22m 


Boldface off 


ISO 


X 


'. X 


X 


[nm 


Set foreground color 












(n - {30-39}) 


ISO 




X 




[nrn 


Set background color 
(„ = {40-49}) 


ISO 








[Ow 


Normal pitch 


DEC 


X 


X 


x 


[2w 


Elite on 


DEC 


X 


X 


x 


[lw 


Elite off 


DEC 


X 


X 


x 


[4w 


Condensed fine on 


DEC 


X 


X 


X 


[3w 


Condensed off 


DEC 


X 


X 


x 


[6w 


Enlarged on 


DEC 


X 


X 


x 


[5w 


Enlarged off 


DEC 


X 


X 


X 


[6"z 


Shadow print on 


DEC 








[5"z 


Shadow print off 


DEC 








[4"z 


Doublestrike on 


DEC 


X 


X 


X 


[3"z 


Doublestrike off 


DEC 


X 


X 


x 


[2"z 


NLQ on •• 


DEC 


X 


X 


x 


[l"z 


NLQ off •• 


DEC 


X 


X 


X 



Entire escape sequence consists of ESC (ASCII 27) plus indicated code. 

• Near Letter Quality 

* * Sequence unique to Amiga 
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Printer 


name: 




CBM 


Epson 


Epson 








MPS-1000 


JX-80 


X-80 


Code 


Description 


Defined 






[2v 


Superscript on 


••• 


X 


X 


X 


[lv 


Superscript off 


•*• 


X 


X 


X 


[4v 


Subscript on 


••• 


X 


X 


X 


[3v 


Subscript off 


••» 


X 


X 


X 


[Ov 


Normalize the line 


••* 


X 


X 


X 


L 


Partial line up 


ISO 


X 


X 


X 


K 


Partial line down 


ISO 


X 


X 


X 


(B 


U.S. char, set 


DEC 


X 


X 


X 


(R 


French " " 


DEC 


X 


X 


X 


(K 


German " " 


DEC 


X 


X 


X 


(A 


UK " " 


DEC 


X 


X 


X 


(E 


Danish I " " 


DEC 


X 


X 


X 


(H 


Swedish • " 


DEC 


X 


X 


X 


(Y 


Italian " " 


DEC 


X 


X 


X 


(Z 


Spanish " " 


DEC 


X 


X 


X 


(J 


Japanese " " 


• •• 


X 


X 


X 


(6 


Norwegian " " 


DEC 


X 


X 


X 


(C 


Danish II "" 


»•• 


X 


X 


X 


[2P 


Proportional on 


• •• 


X 


X 


X 


[IP 


Proportional off 


*•• 


X 


X 


X 


[Op 


Proportional clear 


• *• 








[n E 


Set prop, offset (n) 


ISO 








[5F 


Auto left justify 


ISO 




X 


X 


[7F 


Auto right justify 


ISO 




X 


X 


[«F 


Auto full justify 


ISO 


X 


X 


X 


[0 F 


Justify off 


ISO 


X 


X 


X 


[3F 


Letter space (justify) 


ISO 




X 


X 


[IF 


Word fill (auto center) 


ISO 




X 


X 


[Oz 


1/8" line spacing 


• *• 


X 


X 


X 


[lz 


1/6" line spacing 


*•• 


X 


X 


X 


[it 


Set form length (n) 


DEC 


X 


X 


X 


[nq 


Perf skip (n>0) * 


• •• 


X 


X 


X 


[Oq 


Perf skip off 


• •• 


X 


X 


X 



'Paper perforation skip, n lines 



- 1-34 - 



Printer name: CBM Epson Epson 

MPS-1000 JX-80 X-80 

Code Description Defined 



#9 Left margin set ••• 

#0 Right margin set ••• 

#8 Top margin set ••• 

#2 Bottom margin set *•• 

XX X 

#3 Clear margins ••* x x x 



wt. Duuuin margin sei »»» 

[nl;n2i Top;Bottom margins dec 

[nl;n2s Left;Right margins dec 

#3 Clear maroinc ••• 



H Set horiz. tab iso 

J Set vert, tab iso 

[Og Clear horiz. tab iso 

[3g Clear all hor. tabs iso x x x 

[lg Clear vert, tab iso 

[4g Clear all vert, tabs iso x x x 

#4 Clear all h & v tabs ••• x x x 

#5 Set default tabs ••• x x x 

[n"x (Extended commands) ••* 
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Printer 


name: 




Diablo 
Advantage25 


Diablo 
C-1S0 


Okimate 20 


Code* 


Description 


Defined 






c 


Reset 


ISO 


X 


X 


X 


#1 


Initialize 


•*« 


X 


X 


X 


D 


Line feed 


ISO 








E 


Line feed. CR 


ISO 


X 


X 


X 


M 


Reverse line feed 


ISO 


X 






[Om 


Normal char, set 


ISO 


X 




X 


[3m 


Italics on 


ISO 






X 


[23m 


Italics off 


ISO 






X 


[4m 


Underline on 


ISO 


X 




X 


(24m 


Underline off 


ISO 


X 




X 


[lm 


Boldface on 


ISO 


X 






[22m 


Boldface off 


ISO 


X 






[nm 


Set foreground color 












(n = {30-39}) 


ISO 


X 


X 




[nm 


Set background color 












(n m {40-49}) 


ISO 




X 




[Ow 


Normal pitch 


DEC 


X 




X 


[2w 


Elite on 


DEC 


X 




X 


[lw 


Elite off 


DEC 


X 




X 


[4w 


Condensed fine on 


DEC 


X 




X 


[3w 


Condensed off 


DEC 


X 




X 


[6w 


Enlarged on 


DEC 






X 


[5w 


Enlarged off 


DEC 






X 


[6"z 


Shadow print on 


DEC 


X 






[5"z 


Shadow print off 


DEC 


X 






[4"z 


Doublestrike on 


DEC 


X 






[3"z 


Doublestrike off 


DEC 


X 






[2 B z 


NLQ on •• 


DEC 






X 


[1-z 


NLQ off •* 


DEC 






X 



Entire escape sequence consists of ESC (ASCII 27) plus indicated code. 
* Near Letter Quality 
*" Sequence unique to Amiga 
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Printei 


- name: 




Diablo Diablo 
Advantage25 C-150 


Okimate 20 


Code 


Description 

Superscript on 


Defined 




[2v 


••• 


X X 


X 


[lv 


Superscript off 


*«• 


X X 


X 


[4v 


Subscript on 


•** 


X X 


X 


[3v 


Subscript off 


«** 


X X 


X 


[Ov 


Normalize the line 


•»• 


X X 


X 


L 


Partial line up 


ISO 


X 


X 


K 


Partial line down 


ISO 


X 


X 


(B 


U.S. char, set 


DEC 






(R 


French " " 


DEC 






(K 


German " " 


DEC 






(A 


UK " " 


DEC 






(E 


Danish I " " 


DEC 






(H 


Swedish " " 


DEC 






(Y 


Italian " " 


DEC 






(Z 


Spanish " " 


DEC 






(J 


Japanese " " 


»•• 






(6 


Norwegian " " 


DEC 






(C 


Danish II " " 


• •« 






[2p 


Proportional on 


• «* 


X 


X 


(IP 


Proportional off 


• a* 


X 


X 


[Op 


Proportional clear 


• •« 


X 


X 


[n E 


Set prop, offset («) 


ISO 


X 




15 F 


Auto left justify 


ISO 


X 




[7 F 


Auto right justify 


ISO 






(6 F 


Auto full justify 


ISO 






[0 F 


Justify off 


ISO 


X 




[3F 


Letter space Oustify) 


ISO 






[1 F 


Word fill (auto center) 


ISO 






[Oz 


1/8" line spacing 


• «• 


X 


x 


[lz 


1/6" line spacing 


• •• 


. X 


x 


[>n 


Set form length (n) 


DEC 


X X 


x 


[nq 


Perf skip (n>0) * 


«•• 


X 


x 


[Oq 

'Panoi 


Perf skip off 


••• 


X 


X 
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Printer name: 



Diablo Diablo 

Advantage25 C-150 



Okimate 20 



Code Description 



Defined 



#9 Left margin set 

#0 Right margin set 

#8 Top margin set 

#2 Bottom margin set 

[n/;n2rTop;Bottom margins 
[nl;n 2s Left -.Right margins 
#3 Clear margins 



• •• 


X 


X 


• •• 


X 


X 


• •• 


X 




»•• 


X 




DEC 






DEC 


X 


X 


«•• 


X 


X 


ISO 


X 


X 


ISO 


X 




ISO 


X 


X 


ISO 


X 


X 


ISO 


X 




ISO 






• •• 


X 


X 


• •• 


X 


X 



H Set horiz. tab 

J Set vert, tab 

[Og Clear horiz. tab 

[3g Clear all hor. tabs 

[lg Clear vert, tab 

[4g Clear all vert, tabs 

#4 Clear all h & v tabs 

#5 Set default tabs 

[n"x (Extended commands) 
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Prime: 


r name: 




HP 


HP 


Qume 








LaserJet 


LaserJet Plus LetterPro 20 


Code* 


' Description 
Reset 


Defini 

ISO 


ed 






c 


X 


X 


X 


#1 


Initialize 


• •• 


X 


X 


X 


D 


Line feed 


ISO 


X 


X 


X 


E 


Line feed, CR 


ISO 


X 


X 


X 


M 


Reverse line feed 


ISO 






X 


[Om 


Normal char, set 


ISO 


X 


X 


X 


[3m 


Italics on 


ISO 


X 


X 




[23m 


Italics off 


ISO 


X 


X 




[4m 


Underline on 


ISO 


X 


X 


X 


[24m 


Underline off 


ISO 


X 


X 


X 


[lm 


Boldface on 


ISO 


X 


X 


X 


[22m 


Boldface off 


ISO 


X 


X 


X 


[nm 


Set foreground color 












(n ■ {30-39}) 


ISO 






X 


[nm 


Set background color 
(n « {40-49}) 


ISO 








[Ow 


Normal pitch 


DEC 


X 


X 


X 


[2w 


Elite on 


DEC 


X 


X 


X 


[lw 


Elite off 


DEC 


X 


X 


X 


[4w 


Condensed fine on 


DEC 


X 


X 


X 


[3w 


Condensed off 


DEC 


X 


X 


x 


[6w 


Enlarged on 


DEC 








[5w 


Enlarged off 


DEC 








[6"z 


Shadow print on 


DEC 






x 


[5"z 


Shadow print off 


DEC 






x 


[4"z 


Doublestrike on 


DEC 


X 


X 


x 


[3"z 


Doublestrike off 


DEC 


X 


X 


x 


[2"2 


NLQ on •• 


DEC 








[l"z 


NLQ off •• 


DEC 









Near Letter Quality 
* Sequence unique to Amiga 
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Printer name: 




HP 


HP 


Qume 








LaserJet 


LaserJet Plus LetterPro 20 


Code 


Description 

Superscript on 


Defin 

••• 


ed 






[2v 


X 


X 


X 


[lv 


Superscript off 


••• 


X 


X 


X 


[4v 


Subscript on 


••• 


X 


X 


X 


[3v 


Subscript off 


••• 


X 


X 


X 


[Ov 


Normalize the line 


••• 


X 


X 


X 


L 


Partial line up 


ISO 


X 


X 


X 


K 


Partial line down 


ISO 


X 


X 


X 


(B 


U.S. char, set 


DEC 


X 


X 




(R 


French " " 


DEC 








(K 


German " " 


DEC 








(A 


UK " " 


DEC 


X 


X 




(E 


Danish I " " 


DEC 








(H 


Swedish " " 


DEC 








(Y 


Italian " " 


DEC 








(Z 


Spanish " " 


DEC 








(J 


Japanese " " 


*•• 


X 


X 




(6 


Norwegian " " 


DEC 








(C 


Danish II " " 


• •• 








[2p 


Proportional on 


• •• 


X 


X 


X 


[IP 


Proportional off 


«•• 


X 


X 


X 


[Op 


Proportional clear 


• •• 


X 


X 


X 


[n E 


Set prop, offset (n) 


ISO 






X 


[5F 


Auto left justify 


ISO 








[7 F 


Auto right justify 


ISO 








[6F 


Auto full justify 


ISO 








[0 F 


Justify off 


ISO 


X 






[3F 


Letter space (justify) 


ISO 








[IF 


Word fill (auto center) 


ISO 








[Oz 


1/8" line spacing 


• •• 


X 


X 


X 


[lz 


1/6" line spacing 


• •• 


X 


X 


X 


[it 


Set form length (n) 


DEC 


X 


X 


X 


[nq 


Perf skip (n>0) * 


• •• 


X 


X 




[Oq 


Perf skip off 


••• 


X 


X 





'Paper perforation skip, n lines 
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Printer name: 



HP HP Qume 

LaserJet LaserJet Plus LetterPro 20 



Code Description 



Defined 



#9 Left margin set 

#0 Right margin set 

#8 Top margin set 

#2 Bottom margin set 

[n I ;n2i Top;Bottom margins 
[n 1 ;n 2s Left; Right margins 
#3 Clear margins 



x 

X 



• »• 

• •* 
DEC 
DEC 

• •• 



X 
X 
X 



X 
X 
X 



H Set horiz. tab iso 

J Set vert, tab iso 

[Og Clear horiz. tab iso 

[3g Clear all hor. tabs iso 

[lg Clear vert, tab iso 

[4g Clear all vert, tabs iso 

#4 Clear all h & v tabs ••• 

#5 Set default tabs ••• 

[Pn"x (Extended commands) *•• 
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- 1-A1 - 



Appendix J 
Software Memory Map 



This appendix is for the convenience of the software 'developer who may be directly accessing 
the system hardware registers. It is simply the hardware memory map appropriate to the 
ROM Kernel manual. 

A true software memory map, showing system utilization of the various sections of RAM and 
free space is not provided. The system is dynamically allocated and linked such that it 
would not be possible to show precisely which parts of RAM are utilized by the ROM Kernel. 
User code, if written with the Amiga Assembler or Amiga C, and linked by the Amiga linker 
is relocatable and can load and execute wherever there is a large enough area of memory in 
which it can fit. 

Therefore, aside from specifying that Exec manages the lowest parts of the 68000 memory 
space (exception and trap vectors), no actual software memory utilization map can be pro- 
vided. 
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SYSTEM MEMORY MAP - 

This system memory map for the ROM Kernel manual is a combination 
of the Appendicies D (mem. map) and F (8520 info) from the Amiga PC 
Hardware Manual. Actual bit assignments for the 8520 's and current 
additional details can be found in the Amiga Hardware Manual . 

Note: If you select to read or write an address that is not 

specifically decoded, you WILL generate an address error. 

ADDRESS RANGE NOTES 

[ 256k RAM ] 

000000-3FFFFF RAM space for 256k RAM 

040000-080000 Not used if extra 256k board not installed. 

Do NOT access in this range - dangerous side effects. 

[ 512k RAM ] 
000000-07FFFF RAM space for 512k RAM 
080000-1FFFFF Do NOT access in this range. 

200000-9FFFFF Expansion space ( 8 megabytes ) 



A00000-BEFFFF External decoder expansion space 



Reserved for future use. 
See note (1) below. 



BFD000-BFDF00 8520-B (accessed only at 

EVEN byte addresses) 

The underlined digit chooses which of the 16 
internal registers of the 8520 is to be 
accessed. See also note (5) 
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ADDRESS RANGE NOTES 

BFE001-BFEF01 8520-A (accessed only at 

ODD byte addresses) 

The underlined digit chooses which of the 16 
internal registers of the 8520 is to be 
accessed . 

Register Names are given in note (2) below. 

Other addresses in the range of: 



C00000-DFEFFF 
DFF000-DFFFFF 



E00000-E7FFFF 
E80000-EFFFFF 

F00000-F7FFFF 
F80000-FFFFFF 



Reserved for future use 

Special purpose chips, where 
the last three digits specify 
the chip register WORD address. 

The chip addresses are specified 
in separate pages immediately 
following this overall memory 
map. 

Reserved for future use. 

Expansion Slot decoding, see 
note (1) below. 

Reserved for future use. 

SYSTEM ROM or kickstart RAM. 
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NOTES FOR THE SYSTEM MEMORY MAP: 

(1) Expansion Slot decoding: 

Boards designed to respond in this range must adhere to the 
auto-configuration guidelines to be published in Dec. 1985 
by Commodore-Amiga Inc. 
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(2) The names of the registers within the 8520's are 

as follows. The address at which each are to be 

accessed (per note 1 above) is given here in this list. 

Address for: 



"B" 



8520 -A 8520 -B | NAME | EXPLANATION 

(write) / (read mode) 

BFE001 BFD000 PRA Peripheral Data Register A 

BFE101 BFD100 PRB Peripheral Data Register B 

BFE201 BFD200 DDRB Data Direction Register "A 

BFE301 BFD300 DDRA Data Direction Register 

BFE401 BFD400 TALO TIMER A Low Register 

BFE501 BFD500 TAHI TIMER A High Register 

BFE601 BFD600 TBLO TIMER B Low Register 

BFE701 BFD700 TBHI TIMER B High Register 

BFE801 BFD800 TODLO Low TOD Clock 

BFE901 BFD900 TODMID Mid TOD Clock 

BFEA01 BFDA00 TODHI High TOD Clock Register 

BFEB01 BFDB00 Unused 

BFEC01 BFDC00 SDR Serial Data Register 

BFED01 BFDD00 ICR Interrupt Control Register 

BFEE01 BFDE00 CRA Control Register A 

BFEF01 BFDF00 CRB Control Register B 



SPECIAL PURPOSE CHIP ADDRESSES 

The following . are the "offset" addresses for the 
special purpose chips in the Amiga PC. Each address 
figure shown below must be added to the base address of 
hex DFF000. Again the addressing follows the 
convention shown in note 1 of the system memory map. 



Each register is 
boundary . 



located at an even WORD (16 -bit) 



NAME 



OFFSET R/W EXPLANATION 



ADKCON 


09E 


W 


Audio, Disk, Control write 


ADKCONR 


010 


R 


Audio, disk, Control read 


AUDODAT 


OAA 


W 


Audio channel Data 


AUDOLCH 


0A0 


W 


Audio channel location (High 3 bits) 


AUDOLCL 


0A2 


W 


Audio channel location (Low 16 bits) 


AUDOLEN 


0A4 


W 


Audio Channel length 


AUDOPER 


0A6 


w 


Audio channel Period 


AUD0VOL 


0A8 


w 


Audio Channel Volume 
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NAME 

AUD1DAT 
AUD1LCH 
AUD1LCL 
AUD1LEN 
AUD1PER 
AUD1V0L 
AUD2DAT 
AUD2LCH 
AUD2LCL 
AUD2LEN 
AUD2PER 
AUD2VOL 
AUD3DAT 
AUD3LCH 
AUD3LCL 
AUD3LEN 
AUD3PER 
AUD3VOL 

BLTAFWM 
BLTALWM 
BLTCONO 
BLTCON1 
BLTSIZE 



BLTADAT 
BLTAMOD 
BLTAPTH 

BLTAPTL 

BLTBDAT 
BLTBMOD 
BLTBPIH 

BLTBPTL 
BLTCDAT 
BLTCMOD 
BLTCPTH 

BLTCPTL 
BLTDMOD 
BLTDPTH 

BLTDPTL 
BPL1MOD 
BPL2MOD 



OFFSET R/W EXPLANATION 



OBA W 

0B0 W 

0B2 W 

0B4 W 

0B6 W 

0B8 W 

OCA W 

0C0 W 



0D6 
0D8 



0C2 W 

0C4 W 

0C6 W 

0C8 W 

ODA W 

0D0 W 

0D2 W 

0D4 W 



W 
W 



044 W 
046 W 
040 
042 



W 
W 



058 W 



074 W 

064 W 

050 W 

052 W 

072 W 

062 W 

04C W 

04E W 

070 W 

060 W 

048 W 

04A W 

066 W 

054 W 

056 W 

108 W 

10A W 



Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 
Audio 



channel 
channel 
channel 
Channel 
channel 
Channel 
channel 
channel 
channel 
Channel 
channel 
Channel 
channel 
channel 
channel 
Channel 
channel 
Channel 



Data 

location 

location 

length 

Period 

Volume 

Data 

location 

location 

length 

Period 

Volume 

Data 

location 

location 

length 

Period 

Volume 



(High 3 bits) 
(Low 16 bits) 



(High 3 bits) 
(Low 16 bits) 



(High 3 bits) 
(Low 16 bits) 



Blitter first word mask for source A 
Blitter last word mask for source A 
Blitter control register 
Blitter control register 1 
Blitter start and size 

(window width, height) 

Blitter source A data reg 

Blitter Modulo A 

Blitter Pointer to src or dst.A 

(High 3 bits) 
Blitter Pointer A (Low 16 bits) 

Blitter source B data reg 

Blitter Modulo B 

Blitter Pointer to src or dst.B 

(High 3 bits) 
Blitter Pointer B (Low 16 bits) 
Blitter source C data reg 
Blitter Modulo C J 
Blitter Pointer to src or dst.C 

(High 3 bits) 
Blitter Pointer C (Low 16 bits) 
Blitter Modulo D 
Blitter Pointer to src or dst.D 

(High 3 bits) 
Blitter Pointer D (Low 16 bits) 
Bit plane modulo (odd planes) 
Bit Plane modulo (even planes) 
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NAME 



OFFSET R/W EXPLANATION 



BPLCONO 


100 


W 


Bit plane 


control reg. (misc control bits) 


BPLC0N1 


102 


W 


Bit plane 


control reg. (priority control) 


BPLCON2 


104 


W 


Bit Plane 


control reg. (horiz scroll 












control) 


BPL1DAT 


110 


W 


Bit plane 


1 data 










(Parallel 


to serial 


convert) 


BPL2DAT 


112 


W 


Bit plane 


2 data 










(Parallel 


to serial 


convert) 


BPL3DAT 


114 


w 


Bit plane 


3 data 










(Parallel 


to serial 


convert) 


BPL4DAT 


116 


w 


Bit plane 


4 data 










(Parallel 


to serial 


convert) 


BPL5DAT 


118 


w 


Bit plane 


5 data 










(Parallel 


to serial 


convert) 


BPL6DAT 


11A 


w 


Bit plane 


6 data 










(Parallel 


to serial 


convert) 


BPL1PTH 


0E0 


w 


Bit plane 


1 pointer 


(High 3 bits) 


BPL1PTL 


0E2 


w 


Bit plane 


1 pointer 


(Low 16 bits) 


BPL2PTH 


0E4 


w 


Bit plane 


2 pointer 


(High 3 bits) 


BPL2PTL 


0E6 


w 


Bit plane 


2 pointer 


(Low 16 bits) 


BPL3PTH 


0E8 


w 


Bit plane 


3 pointer 


(High 3 bits) 


BPL3PTL 


0EA 


w 


Bit plane 


3 pointer 


(Low 16 bits) 


BPL4PTH 


0EC 


w 


Bit plane 


4 pointer 


(High 3 bits) 


BPL4PTL 


0EE 


w 


Bit plane 


4 pointer 


(Low 16 bits) 


BPL5PTH 


0F0 


w 


Bit plane 


5 pointer 


(High 3 bits) 


BPL5PTL 


0F2 


w 


Bit plane 


5 pointer 


(Low 16 bits) 


BPL6PTH 


0F4 


w 


Bit plane 


6 pointer 


(High 3 bits) 


BPL6PTL 


0F6 


w 


Bit plane 


6 pointer 


(Low 16 bits) 


CLXCON 


098 


w 


Collision 


control 




CLXDAT 


00E 


R 


Collision 


data reg. 


[Read and clear) 


COLORxx 


180 


w 


Color table xx 










(32 WORD ENTRIES, START COLOR 00) 


COP1LCH 


080 


w 


Coprocessor first location reg 










(High 3 bits) 


COP1LCL 


082 


w 


Coprocessor first location reg. 










(Low 16 bits) 


COP2LCH 


084 


w 


Coprocessor secnd location reg. 










(High 3 bits) 


COP2LCL 


086 


w 


Coprocessor second '. 


Location reg 










(Low 16 bits) 


COPINS 


08C 


w 


Coprocessor inst. fetch identify 


COPJMP1 


088 


s 


Coprocessor restart 


at first location 


COPJMP2 


08A 


s 


Coprocessor restart 


at second location 


DDFSTOP 


094 


w 


Display bit plane 










data 


fetch stop(hor pos) 


DDFSTRT 


092 


w 


Display b 


it plane 





data fetch start (hor pos) 
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NAME 

DIWSTOP 

DIWSTRT 



DMACON 
DMACONR 

DSKBYTR 

DSKDAT 

DSKDATR 

DSKLEN 
DSKPIH 
DSKPTL 

INTENA 

INTENAR 

INTREQ 

INTREQR 

JOYODAT 
JOY1DAT 

POTODAT 

POT1DAT 

POTGO 
POTINP 

REFPTR 
SERDAT 
SERDATR 
SERPER 

SPROPOS 

SPROCTL 

SPRODATA 
SPRODATB 
SPRIPOS 

SPR1CTL 

SPR1DATA 
SPR1DATB 



OFFSET R/W EXPLANATION 



090 W 
08E W 



096 W 

002 R 

01A R 

026 W 

008 ER 

024 W 

020 W 

022 W 

09A W 

01C R 

09C W 

01E R 

00A R 

00C R 

012 R 

014 R 

034 W 

016 R 

028 W 

030 W 

018 R 

032 W 

140 W 

142 W 

144 W 

146 W 

148 W 



14A W Sprite 1 



14C W 

14E W 



Disp Window Stop 

(lower right vert-hor pos) 
Disp Window Start 

(upper left vert-hor pos) 

DMA control write (clear or set) 

DMA control (and blitter status) read 

Disk Data byte and status read 
Disk DMA Data write 
Disk DMA Data read 

(early read dummy address) 
Disk length 

Disk pointer (High 3 bits) 
Disk pointer (Low 16 bits) 

Interrupt Enable bits 

(clear or set bits) 
Interrupt Enable bits Read 
Interrupt Request bits (clear or set) 
Interrupt request bits (read) 

Joystick-mouse data (vert,horiz) 
Joystick-mouse 1 data (vert,horiz) 

Pot counter data left pair 

(vert,horiz) 
Pot counter data right pair 

(vert,horiz) 
Pot Port (4 bit) Direction and Data, 
Pot pin data read 

Refresh pointer 

Serial Port Data and stop bits write 
Serial Port Data and Status read 
Serial Port Period and control 

Sprite Vert-Horiz start 

position data 
Sprite Vert stop position and 

control data 
Sprite image data register A 
Sprite image data register B 
Sprite 1 Vert-Horiz start 

position data 
Vert stop position and 

control data 
Sprite 1 image data register A 
Sprite 1 image data register B 
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NAME 



OFFSET R/W EXPLANATION 



SPR2P0S 


150 


W 


Sprite 2 Vert-Horiz start 










position 


data 




SPR2CTL 


152 


W 


Sprite 2 Vert stop position and 








control 


data 




SPR2DATA 


154 


W 


Sprite 2 image data register A 


SPR2DATB 


156 


w 


Sprite 2 image data register B 


SPR3POS 


158 


w 


Sprite 3 Vert-Horiz start 










position 


data 




SPR3CTL 


15A 


w 


Sprite 3 Vert stop positi 


on and 








control 


data 




SPR3DATA 


15C 


w 


Sprite 3 image data register A 


SPR3DATB 


15E 


w 


Sprite 3 image data register B 


SPR4P0S 


160 


w 


Sprite 4 Vert-Horiz start 










position 


data 




SPR4CTL 


162 


w 


Sprite 4 Vert stop positi 


on and 








control 


data 




SPR4DATA 


164 


w 


Sprite 4 image data register A 


SPR4DATB 


166 


w 


Sprite R image data register B 


SPR5P0S , 


168 


w 


Sprite 5 Vert-Horiz start 










position 


data 




SPR5CTL 


16A 


w 


Sprite 5 Vert stop position and 








control 


data 




SPR5DATA 


16C 


w 


Sprite 5 image data register A 


SPR5DATB 


16E 


w 


Sprite 5 image data register B 


SPR6P0S 


170 


w 


Sprite 6 Vert-Horiz start 








position 


data 




SPR6CTL 


172 


w 


Sprite 6 Vert stop position and 








control 


data 




SPR6DATA 


174 


w 


Sprite 6 image data register A 


SPR6DATB 


176 


w 


Sprite 6 image data register B 


SPR7P0S 


178 


w 


Sprite 7 Vert-Horiz start 








position 


i data 




SPR7CTL 


17A 


w 


Sprite 7 Vert stop position and 








control 


data 




SPR7DATA 


17C 


w 


Sprite 7 image data register A 


SPR7DATB 


17E 


w 


Sprite 7 image data register B 


SPROPTH 


120 


w 


Sprite pointer i 


High 3 


bits) 


SPROPTL 


122 


w 


Sprite pointer i 


Low 16 


bits) 


SPR1PTH 


124 


w 


Sprite 1 pointer 


.High 3 


bits) 


SPR1PTL 


126 


w 


Sprite 1 pointer 


[Low 16 


bits) 


SPR2PTH 


128 


w 


Sprite 2 pointer 


High 3 


bits) 


SPR2PTL 


12A 


w 


Sprite 2 pointer 


[Low 16 


bits) 


SPR3PTH 


12C 


w 


Sprite 3 pointer 


[High 3 


bits) 


SPR3PTL 


12E 


w 


Sprite 3 pointer 


Low 16 


bits) 


SPR4PTH 


130 


w 


Sprite 4 pointer 


[High 3 


bits) 


SPR4PTL 


132 


w 


Sprite 4 pointer 


Low 16 


bits) 


SPR5PTH 


134 


w 


Sprite 5 pointer 


[High 3 


bits) 


SPR5PTL 


136 


w 


Sprite 5 pointer 


Low 16 


bits) 


SPR6PTH 


138 


w 


Sprite 6 pointer 


High 3 


bits) 


SPR6PTL 


13A 


w 


Sprite 6 pointer 


Low 16 


bits) 


SPR7PTH 


13C 


w 


Sprite 7 pointer 


'High 3 


bits) 


SPR7PTL 


13E 


w 


Sprite 7 pointer 


Low 16 


bits) 
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NAME 



OFFSET R/W EXPLANATION 



STREQU 
STRHOR 
STRLONG 


038 
03C 
03E 


S 
S 
S 


STRVBL 


03A 


S 


VHPOSR 
VHPOSW 
VPOSR 


004 
02A 
006 


R 
W 
R 


VPOSW 


02C 


W 



Strobe for horiz sync with VB and EQU 
Strobe for horiz sync 
Strobe for identification of 

long horzontal line. 
Strobe for horiz sync 

with VB (Vert. Blank) 
Read Vert and horiz Position of beam 
Write Vert and horiz Position of beam 
Read Vert most sig. bit 

(and frame flop) 
Write Vert most sig. bit 

(and frame flop) 



The following listing of the chip special purpose addresses 
is provided in numerical order by chip address for the 
convenience of software developers who may prefer this 
ordering sequence. 

DMA control (and blitter status) read 

Read Vert and horiz Position of beam 

Read Vert most sig. bit (and frame flop) 

Disk DMA Data read (early read dummy address) 

Joystick-mouse data (vert, horiz) 

Joystick-mouse 1 data (vert, horiz) 

Collision data reg. (Read and clear) 

Audio, disk, Control read 

Pot counter data left pair (vert, horiz) 

Pot counter data right pair (vert, horiz) 

Pot pin data read 

Serial Port Data and Status read 

Disk Data byte and status read 

Interrupt Enable bits Read 

Interrupt request bits (read) 

Disk pointer (High 3 bits) 

Disk pointer (Low 16 bits) 

Disk length 

Disk DMA Data write 

Refresh pointer 

Write Vert and horiz Position of beam 

Write Vert most sig. bit (and frame flop) 

Serial Port Data and stop bits write 

Serial Port Period and control 

Pot Port (4 bit) Direction and Data, 

Strobe for horiz sync with VB and EQU 

Strobe for horiz sync with VB (Vert. Blank) 

Strobe for horiz sync 

Strobe for ident. of long horzontal line. 

Blitter control register 

Blitter control register 1 

Blitter first word mask for source A 

Blitter last word mask for source A 

Blitter Pointer to src or dst.C (High 3 bits) 



DMACONR 


002 


R 


VHPOSR 


004 


R 


VPOSR 


006 


R 


DSKDATR 


008 


ER 


JOY0DAT 


00A 


R 


J0Y1DAT 


00C 


R 


CLXDAT 


00E 


R 


ADKCONR 


010 


R 


POT0DAT 


012 


R 


POT1DAT 


014 


.R 


POTINP 


016 


R 


SERDATR 


018 


R 


DSKBYTR 


01A 


R 


INTENAR 


01C 


R 


INTREQR 


01E 


R 


DSKPTH 


020 


W 


DSKPTL 


022 


W 


DSKLEN 


024 


W 


DSKDAT 


026 


W 


REFPTR 


028 


W 


VHPOSW 


02A 


W 


VPOSW 


02C 


W 


SERDAT 


030 


W 


SERPER 


032 


W 


POTGO 


034 


W 


STREQU 


038 


S 


STRVBL 


03A 


S 


STRHOR 


03C 


S 


STRLONG 


03E 


S 


BLTCON0 


040 


W 


BLTC0N1 


042 


W 


BLTAFWM 


044 


w 


BLTALWM 


046 


w 


BLTCPTH 


048 


w 
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BLTCPTL 

BLTBPTH 

BLTBPTL 

BLTAPTH 

BLTAPTL 

BLTDPTH 

BLTDPTL 

BLTSIZE 

BLTCMOD 

BLTBMOD 

BLTAMOD 

BLTDMOD 

BLTCDAT 

BLTBDAT 

BLTADAT 

COP1LCH 

COP1LCL 

COP2LCH 

COP2LCL 

COPJMP1 

COPJMP2 

COPINS 

DIWSTRT 

DIWSTOP 

DDFSTRT 

DDFSTOP 

DMACON 

CLXCON 

INTENA 

INTREQ 

ADKCON 

AUDOLCH 

AUDOLCL 

AUDOLEN 

AUDOPER 

AUD0VOL 

AUDODAT 

AUD1LCH 

AUD1LCL 

AUD1LEN 

AUD1PER 

AUD1VOL 

AUD1DAT 

AUD2LCH 

AUD2LCL 

AUD2LEN 

AUD2PER 

AUD2VOL 

AUD2DAT 

AUD3LCH 

AUD3LCL 

AUD3LEN 

AUD3PER 

AUD3VOL 

AUD3DAT 

BPL1FIH 



04A W 

04C W 

04E W 
050 
052 

054 W 

056 W 

058 W 

060 W 

062 W 



W 
W 



064 W 

066 W 

070 W 

072 W 



W 

w 



074 W 

080 W 

082 W 

084 W 

086 W 

088 S 

08A S 

08C W 

08E W 
090 
092 

094 W 

096 W 

098 W 

09A W 

09C W 

09E W 

0A0 W 

0A2 W 

0A4 W 

0A6 W 

0A8 W 

OAA W 

0B0 W 

0B2 W 

0B4 W 

0B6 W 

0B8 W 



OBA W 

0C0 W 

0C2 W 

0C4 W 

0C6 W 

0C8 W 

OCA W 

0D0 W 

0D2 W 

0D4 W 

0D6 W 

0D8 W 

ODA W 

0E0 W 



(High 3 bits) 
(High 3 bits) 
(High 3 bits) 



Blitter Pointer C (Low 16 bits) 

Blitter Pointer to src or dst.B 

Blitter Pointer B (Low 16 bits) 

Blitter Pointer to src or dst.A 

Blitter Pointer A (Low 16 bits) 

Blitter Pointer to src or dst.D 

Blitter Pointer D (Low 16 bits) 

Blitter start and size (window width, height) 

Blitter Modulo C 

Blitter Modulo B 

Blitter Modulo A 

Blitter Modulo D 

Blitter source C data reg 

Blitter source B data reg 

Blitter source A data reg 

Coprocessor first location reg (High 3 bits) 

Coprocessor first location reg. (Low 16 bits) 

Coprocessor secnd location reg. (High 3 bits) 

Coprocessor second location reg (low 16 bits) 

Coprocessor restart at first location 

Coprocessor restart at second location 

Coprocessor inst. fetch identify 

Disp Window Start (upper left vert-hor pos) 

Disp Window Stop (lower right vert-hor pos) 

Display bit plane data fetch start (hor pos) 

Display bit plane data fetch stop (hor pos) 

DMA control write (clear or set) 

Collision control 

Interrupt Enable bits (clear or set bits) 

Interrupt Request bits (clear or set) 

Audio, Disk, Control write 

Audio channel location (High 3 bits) 



Audio channel 
Audio Channel 
Audio channel 
Audio Channel 
Audio channel 
Audio channel 1 
Audio channel 1 
Audio Channel 1 
Audio channel 1 
Audio Channel 1 
Audio channel 1 
Audio channel 2 
Audio channel 2 
Audio Channel 2 
Audio channel 2 
Audio Channel 2 
Audio channel 2 
Audio channel 3 
Audio channel 3 
Audio Channel 3 
Audio channel 3 
Audio Channel 3 
Audio channel 3 



location (Low 16 bits) 

length 

Period 

Volume 

Data 

location (High 3 bits) 

location (Low 16 bits) 

length 

Period 

Volume 

Data 

location (High 3 bits) 

location (Low 16 bits) 

length 

Period 

Volume 

Data 

location (High 3 bits) 

location (Low 16 bits) 

length 

Period 

Volume 

Data 



Bit plane 1 pointer (High 3 bits) 
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BPL1PTL 


0E2 


W 


BPL2PTH 


0E4 


W 


BPL2PTL 


0E6 


w 


BPL3PTH 


0E8 


w 


BPL3PTL 


OEA 


w 


BPL4PTH 


OEC 


w 


BPL4PTL 


OEE 


w 


BPL5PIH 


0F0 


w 


BPL5PTL 


0F2 


w 


BPL6PTH 


0F4 


w 


BPL6PTL 


0F6 


w 


BPLCONO 


100 


w 


BPLCON1 


102 


w 


BPLCON2 


104 


w 


BPL1MOD 


108 


w 


BPL2MOD 


10A 


w 


BPL1DAT 


110 


w 


BPL2DAT 


112 


w 


BPL3DAT 


114 


w 


BPL4DAT 


116 


w 


BPL5DAT 


118 


w 


BPL6DAT 


11A 


w 


SPROPTH 


120 


w 


SPROPTL 


122 


w 


SPR1PTH 


124 


w 


SPR1PTL 


126 


w 


SPR2PTH 


128 


w 


SPR2PTL 


12A 


w 


SPR3PTH 


12C 


w 


SPR3PTL 


12E 


w 


SPR4PTH 


130 


w 


SPR4PTL 


132 


w 


SPR5PTH 


134 


w 


SPR5PTL 


136 


w 


SPR6PTH 


138 


w 


SPR6PTL 


13A 


w 


SPR7PTH 


13C 


w 


SPR7PTL 


13E 


w 


SPROPOS 


140 


w 


SPROCTL 


142 


w 


SPRODATA 


144 


w 


SPRODATB 


146 


w 


SPR1POS 


148 


w 


SPR1CTL 


14A 


w 


SPR1DATA 


14C 


w 


SPR1DATB 


14E 


w 


SPR2POS 


150 


w 


SPR2CTL 


152 


w 


SPR2DATA 


154 


w 


SPR2DATB 


156 


w 


SPR3POS 


158 


w 


SPR3CTL 


15A 


w 


SPR3DATA 


15C 


w 


SPR3DATB 


15E 


w 


SPR4P0S 


160 


w 


SPR4CTL 


162 


w 



Bit plane 1 pointer (Low 16 bits) 

Bit plane 2 pointer (High 3 bits) 

Bit plane 2 pointer (Low 16 bits) 

Bit plane 3 pointer (High 3 bits) 

Bit plane 3 pointer (Low 16 bits) 

Bit plane 4 pointer (High 3 bits) 

Bit plane 4 pointer (Low 16 bits) 

Bit plane 5 pointer (High 3 bits) 

Bit plane 5 pointer (Low 16 bits) 

Bit plane 6 pointer (High 3 bits) 

Bit plane 6 pointer (Low 16 bits) 

Bit plane control reg. (misc control bits) 

Bit plane control reg. (priority control) 

Bit Plane control reg. (horiz scroll control) 

Bit plane modulo (odd planes) 

(even planes) 

(Parallel to serial convert) 

(Parallel ■ • - 

(Parallel 

(Parallel 



Bit Plane modulo 

Bit plane 1 data 

Bit plane 

Bit plane 

Bit plane 

Bit plane 

Bit plane 



2 
3 
4 
5 
6 



Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 

Sprite 







1 

1 

2 

2 

3 

3 

4 

4 

5 

5 

6 

6 

7 

7 









1 

1 

1 

1 

2 

2 

2 

2 

3 

3 

3 

3 

4 

4 



data 
data 
data 
data 
data 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 
pointer 



to 
to 



serial convert) 

serial convert) 

to serial convert) 

(Parallel to serial convert) 

(Parallel to serial convert) 

(High 3 bits) 

(Low 16 bits) 

(High 3 bits) 

(Low 16 bits) 

(High 3 bits) 

(Low 16 bits) 

(High 3 bits) 

(Low 16 bits) 

(High 3 bits) 

(Low 16 bits) 

(High 3 bits) 

(Low 16 bits) 

(High 3 bits) 

(Low 16 bits) 

(High 3 



. , bits) 

(Low 16 bits) 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
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SPR4DATA 


164 


W 


Sprite 


4 


SPR4DATB 


166 


W 


Sprite 


4 


SPR5P0S 


168 


W 


Sprite 


5 


SPR5CTL 


16A 


W 


Sprite 


5 


SPR5DATA 


16C 


W 


Sprite 


5 


SPR5DATB 


16E 


W 


Sprite 


5 


SPR6P0S 


170 


W 


Sprite 


6 


SPR6CTL 


172 


W 


Sprite 


6 


SPR6DATA 


174 


W 


Sprite 


6 


SPR6DATB 


176 


W 


Sprite 


6 


SPR7P0S 


178 


W 


Sprite 


7 


SPR7CTL 


17A 


W 


Sprite 


7 


SPR7DATA 


17C 


W 


Sprite 


7 


SPR7DATB 


17E 


W 


Sprite 


7 


COLORxx 


180 


W 


Color 1 


:a 



image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Vert-Horiz start position data 
Vert stop position and control data 
image data register A 
image data register B 
Color table xx (32 WORD ENTRIES, START COLOR 00) 



Appendix K 
Skeleton Device, Skeleton Library 



This appendix contains source code for a skeleton device and a skeleton library. You can use 
this code to create your own custom devices and libraries to add to the Amiga. 
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**************************** ********************************************* 

* 

* Copyright (C) 1985, Commodore Amiga Inc. All rights reserved. * 

* * 
************************************************************************* 

************************************************************************* 

* 

* asmsupp.i -- random low level assembly support routines 

* Source Control 



* $Header: asmsupp.i, v 31.1 85/10/13 23:12:33 neil Exp $ 
* 

* $Locker : $ 

* 
**************************************************************** 



********* 



CLEAR MACRO ; quick way to clear a D register on 68000 

MOVEQ #0.\1 
ENDM 

HHS MACRO 

BCC.\0 \1 
ENDM 

BLO MACRO 

BCS.\0 \1 
ENDM 



EVEN MACRO 

DS.W 

ENDM 



; word align code stream 



LINKSYS MACRO ; link to a library without having to see a LVO 

LINKLIB _LVO\l,\2 
ENDM 

CALLSYS MACRO ; call a library without having to see _LV0 

CALLLIB _LVO\l 

ENDM 



XLIB MACRO ; define a library reference without the LVO 

XREF _LVO\l 

ENDM 
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section section 
DEBUG. equ 1 
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*********************************** ********* *********#****»»»»„ ,n # 

* 

* 

* Copyright (C) 1985, Commodore Amiga Inc. All rights reserved. * 

* 

**************************************************** ttHiHH,^^^^^^^ 

* 

* myllb.i — external declarations for skeleton library 

* SOURCE CONTROL 

* 

* $Header: ramlib.i,v 31.1 85/10/13 23:12:51 neil Exp $ 

* $Locker: neil $ 

• 

***********************************************t** i ,i, i ,i, i ,t i , i , i , i , i , ili , itil 



library function definitions 



LIBINIT 

LIBDEF MLFUNCO 

LIBDEF MLFUNC1 



library data structures 



STRUCTURE MyLib,LIB_SIZE 

ULONG ml_SysLlb 

ULONG ml_DosLib 

ULONG ml_SegList 

UBYTE mlJFlags 

UBYTE ml_pad 

LABEL MyLib_Slzeof 



MYLIBNAME MACRO 

DC.B 'myllb. library', 
ENDM 
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************************************************************************* 

* * 

* Copyright (C) 1985, Commodore Amiga Inc. All rights reserved. * 

* * 

A***********************************************************************/ 



* 



************************************************************************* 

* 

* mylib.asm -- skeleton library code 

* 

* Source Control 



* 



* $Header: amain. asm, v 31.3 85/10/18 19:04:04 neil Exp $ 

* 

* $Locker: neil $ 

* 

* $Log: amain. asm, v $ 

* 

************************************************************************/ 
SECTION section 

NOLIST 

include "exec/types . i" 
include "exec/nodes . i" 
include "exec/lists. 1" 
include "exec/libraries.i" 
include "exec/alerts . i" 
include "exec/initializers . i" 
include "exec/resident. i" 
include "libraries/dos.i" 

include "asmsupp.i" 

include "mylib.i" 

LIST 

. These don't have to be external, but it helps some 

'. debuggers to have them globally visible 

XDEF Init 
XDEF Open 
XDEF Close 
XDEF Expunge 
XDEF Null 
XDEF myName 
XDEF MyFuncO 
XDEF MyFuncl 

XREF- _J\bsExecBase 

XLIB Openliibrary 
XLIB CloseLibrary 
XLIB Alert 
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XLIB FreeMem 
XLIB Remove 



Start : 



Hie first executable location. This Should return an error 
in case someone tried to run you as a program (instead of 
loading you as a library) . 



CLEAR 
rts 



dO 



A romtag structure. Both "exec" and "ramlib" look for 
this structure to discover magic constants about you 
(such as where to start running you from. . .) . 



MYPRI 



; Most people will not need a priority and should leave it at zero. 
; the RT_PRI field is used for configuring the roms. Use "mods" from 
; wack to look at the other romtags in the system 
EQU 



initDDescrip : 




DC.W 


RTC_MATCHWORD 


DC.L 


initDDescrip 


DC.L 


EndCode 


DC.B 


RTF_AUTOINIT 


DC.B 


VERSION 


DC.B 


NT_JL.IBRARY 


DC.B 


MYPRI 


DC.L 


myName 


DC.L 


idString 


DC.L 


Init 



STRUCTURE RT, 
UWORD RT_MATCHWORD 
APTR RT_MATCHTAG 
APTR RT_ENDSKIP 
UBYTE RT_FLAGS 
UBYTE RT_VERSION 
UBYTE RT_TYPE 
BYTE RT_PRI 
APTR RT_NAME 
APTR RT_IDSTRING 
APTR RT_INIT 
LABEL RT_SIZE 



myN 



VERSION: 



REVISION: 



idString: 
dosName : 



this is the name that the library will have 
MYLIBNAME 

a major version number. 
EQU 1 

A particular revision. This should uniquely identify the bits in the 
library. I use a script that advances the revision number each time 
I recompile. That way there is never a question of which library 
that really is. J 

EQU 17 

this is an identifier tag to help in supporting the library 
format is 'name version . revision (dd MON yyyy) ',<cr> <lf> <null> 
dc.b 'mylib 1.0 (31 Oct 1985) ',13, 10,0 

DOSNAME 
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; force word al ligament 
ds.w 



Init: 



The romtag specified that we were "RTF^AUTOINIT" . This means 
that the RT_INIT structure member points to one of these 
tables below. If the AUTOINIT bit was not set then RT_INIT 
would point to a routine to run. 



data space size 

pointer to function initializers 
pointer to data initializers 
routine to run 



DC.L 


MyLibJSizeof 


DC.L 


funcTable 


DC.L 


dataTable 


DC.L 


initRoutine 



funcTable : 



del 
del 
del 
del 



del 
del 



del 



standard system routines 

Open 

Close 

Expunge 

Null 

my libraries definitions 

MyFuncO 

MyFuncl 

function table end marker 

-1 



The data table Initializes static data structures. 
The format is specified in exec/InitStruct routine's 
manual pages. The INITBYTE/INITWORD/INITLONG routines 
are in the file "exec/initializers. i". The first argument 
is the offset from the library base for this byte/word/long. 
The second argument is the value to put in that cell. 
The table is null terminated 



dataTable : 

INITBYTE 
INITLONG 
INITBYTE 
INITWORD 
INITWORD 
INITLONG 
DC.L 



LELTYPE , NT_LIHRARY 

LN_>IAME , myName 

LIB_FLAGS, LIBF_SUMUSED ! LIBF_CHANGED 

LIB_VERSION, VERSION 

LIBJtEVISION, REVISION 

LIB_IDSTRING, idString 



; This routine gets called after the library has been allocated. 
• The library pointer is in DO. The segment list is in AO. 
; If it returns non-zero then the library will be linked into 
; the library list. 
initRoutine : 

get the library pointer into a convenient A register 
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1$: 



move . 1 
move . 1 



a5, - (sp) 
d0,a5 



; save a pointer to exec 

move.l a6,ml_SysLib(a5) 

; save a pointer to our loaded code 

move .1 aO , ml_SegLlst (a5) 

. open the dos library 

lea dosName (pc) , al 

CLEAR dO 

CALLSYS QpenLibrary 

move .1 dO , ml_PosLib (a5) 
bne . s 1$ 

; can't open the dos! what gives 

ALERT AG_OpenLib ! AO_DOSLib 

; now build the static data that we need 



put your initialization here. 



move.l a5,d0 
move.l (sp)+,a5 

rts 



here begins the system interface commands. When the user calls 
OpenLibrary/CloseLibrary/RemoveLlbrary, this eventually gets translated 
into a call to the following routines (Open/Close/Expunge) . Exec 
has already put our library pointer in A6 for us. Exec has turned 
off task switching while in these routines (via Forbid/Permit) , so 
we should not take too long in them. 



Open: 



; Open returns the library pointer in dO if the open 

; was successful. If the open failed then null is returned. 

; It might fall if we allocated memory on each open, or 

; if only open application could have the library open 

; at a time. . . 

; ( libptr:a6, version :d0 ) 

/' mark us as having another opener 

addq . w #1 , LIB_OPENCNT (a6) 



bclr 



prevent delayed expunges 
#LIBB_DELEXP, ml_Flags (a6) 
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move.l a6,d0 
rts 



; There are two different things that might be returned from 

; the Close routine. If the library is no longer open and 

; there is a delayed expunge then Close should return the 

; segment list (as given to Init) . Otherwise close should 

; return NULL. 

Close: ; ( libptr:a6 ) 

; set the return value 

CLEAR dO 

; mark us as having one fewer openers 

subq.w #l / LIB_0PENCNT(a6) 

. see if there is anyone left with us open 

bne . s 1$ 

; see if we have a delayed expunge pending 

btst #LIBBJDELEXP , ml_Flags (a6) 
beq.s !$■ 

; do the expunge 

bsr Expunge 
1$: 

rts 

There are two different things that might be returned from 
the Expunge routine. If the library is no longer open 
then Expunge should return the segment list (as given to 
Init) . Otherwise Expunge should set the delayed expunge 
flag and return NULL. 

One other important note: because Expunge is called from 
the memory allocator, it may NEVER Wait() or otherwise 
take long time to complete. 

Expunge: ; ( libptr: a6 ) 

movem . 1 d2/a5/a6 , - (sp) 

move .1 a6 , a5 

move . 1 ml_SysLib (a5) , a6 

. see if anyone has us open 

tst.w LIB_0PENCNT(a5) 
beq 1$ 

. i t i S still open, set the delayed expunge flag 

bset #LIBBJDELEXP / ml_Elags(a5) 

CLEAR dO 

bra . s Expunge_End 
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1$: 

; go ahead and get rid of us. Store our seglist in d2 

move . 1 ml_SegList (a5) , d2 

; unlink from library list 

move.l a5,a0 
CALLSYS Remove 



device specific closings here. 



; close the dos library 

move . 1 ml_PosLib (a5) , al 
CALLSYS CloseLibrary 

; free our memory 

move.l a5,al 

move . 1 LIB_NEGSIZE (a5) , dO 

sub .1 dO , al 

add . 1 LIB_POSSI ZE (a5) , dO 

CALLSYS FreeMem 

; set up our return value 

move.l d2,d0 

Expunge_End : 

movem . 1 (sp) + , d2/a5/a6 
rts 



Null: 

CLEAR dO 
rts 



here begins the library specific commands 



MyFuncO : 

CLEAR dO 
rts 

MyFuncl : 

moveq #l,dO 
rts 



; EndCode is a marker that show the end of your code. 
; Make sure it does not span sections nor is before the 
; rom tag in memory! It is ok to put it right after 
; the rom tag -- that way you are always safe. I put 
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• it here because it happens to be the "right" thing 
; to do, and I know that it is safe in this case. 
EndCode: 

END 
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* Copyright (C) 1985, Commodore Amiga Inc. All rights reserved. * 

* mydev.asm -- skeleton device code 

* 

* Source Control 

* 

* 

* $Header: amain. asm, v 31.3 85/10/18 19:04:04 neil Exp $ 

* $Locker: neil $ 

* 

* $Log: amain. asm, v $ 

SECTION section ' 

NOLIST 

include " exec/types. i" 
include "exec/nodes. i" 
include "exec/lists. i" 
include "exec/libraries. i" 
include "exec/devices. i" 
include "exec/io.i" 
include "exec/alerts. i" 
include "exec/initializers. i" 
include "exec/memory. i" 
include "exec/resident. i" 
include "exec/ables.i" 
include "exec/errors. i" 
include " 1 ibrar ies/dos . i " 
include "1 ibrar ies/dosextens.i" 



include "asmsupp.i" 
include "mydev.i" 
LIST 

; These don't have to be external, but it helps some 

' debuggers to have them globally visible 

XDEF Init 

XDEF Open 

XDEF Close 

XDEF Expunge 

XDEF Null 

XDEF myName 

XDEF BeginIO 

XDEF AbortIO 
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XREF 



^AbsExecBase 



XLIB 
XLIB 
XLIB 


OpenLlbrary 

CloseLibrary 

Alert 


XLIB 


FreeMem 


XLIB 


Remove 


XLIB 


FindTask 


XLIB 


AllocMem 


XLIB 


CreateProc 


XLIB 
XLIB 


PutMsg 
RemTask 


XLIB 
XLIB 
XLIB 
XLIB 


ReplyMsg 
Signal 
GetMsg 
Wait 


XLIB 


WaitPort 


XLIB 

XLIB 


AllocSignal 
SetTaskPri 



INT_ABLES 



; The first executable location. This should return an error 
; in case someone tried to run you as a program (instead of 
; loading you as a library) . 
FirstAddress : 

CLEAR dO 
rts 



A romtag structure. Both "exec" and "ramlib" look for 
this structure to discover magic constants about you 
(such as where to start running you from . . . ) . 



MYPRI 



; Most people will not need a priority and should leave it at zero. 
; the RT_J>RI field is used for configuring the roms. Use "mods" from 
; wack to look at the other romtags in the system 
EQU 



initDDescrip : 




DC.W 


RTC_MATCHWORD 


DC.L 


initDDescrip 


DC.L 


EndCode 


DC.B 


RTF^AUTOINIT 


DC.B 


VERSION 


DC.B 


NT_DEVICE 


DC.B 


MYPRI 


DC.L 


myName 


DC.L 


idString 


DC.L 


Init 



STRUCTURE RT, 


UWORD RT_MATCHWORD 


APTR 


RT_MATCHTAG 


APTR 


RT_ENDSKIP 


UBYTE RT_FLAGS 


UBYTE 


RT_VERSION 


UBYTE 


RT_TYPE 


BYTE 


RT_PRI 


APTR 


RT_NAME 


APTR 


RT_IDSTRING 


APTR 


RT_INIT 



LABEL RT_SIZE 
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; this Is the name that the device will have 
subSysName: 
myName: MYDEVNAME 



VERSION: 



REVISION: 



idString: 
dosName : 



a major version number. 
EQU 1 

A particular revision. This should uniquely Identify the bits in the 
device. I use a script that advances the revision number each time 
I recompile. That way there is never a question of which device 
that really is. 
EQU 17 

this is an identifier tag to help in supporting the device 
format is 'name version . revision (dd MON yyyy) ',<cr>,<lf> <null> 
dc.b 'mydev 1.0 (31 Oct 1985) ',13,10,0 

DOSNAME 



; force word allignment 
ds.w 



Init: 



The romtag specified that we were "RTF_AUTOINIT" . This means 
that the RT_INIT structure member points to one of these 
tables below. If the AUTOINIT bit was not set then RT_INIT 
would point to a routine to run. 



data space size 

pointer to function initializers 
pointer to data Initializers 
routine to run 



DC.L 


MyDev_Sizeof 


DC.L 


funcTable 


DC.L 


dataTable 


DC.L 


initRoutine 



funcTable : 



del 
del 
del 
del 



standard system routines 

Open 

Close 

Expunge 

Null 



del 
del 



my device definitions 

BeglnIO 

AbortIO 



del 



function table end marker 

-1 



The data table initializes static data structures. 
The format is specified in exec/InitStruct routine's 
manual pages. The INITBYTE/INITWORD/INITLONG routines 
are in the file "exec/initializers. i". The first argument 
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; is the offset from the device base for this byte/word/long. 
; The second argument is the value to put in that cell. 
; The table is null terminated 
dataTable : 

INITBYTE LH_TYPE,NT_PEVICE 

INITLONG LN_NAME,myName 

INITBYTE LIB_FLAGS / LIBF_SUMUSED!LIBF_CHANGED 

INITWORD LIB_VERSION, VERSION 

INITWORD LIBJIEVISION, REVISION 

INITLONG LIB_IDSTRING, idString 

DC.L 

; This routine gets called after the device has been allocated. 
; The device pointer is in DO. The segment list is in aO. 
; If it returns non-zero then the device will be linked into 
; the device list. 
initRoutine : 



. gQ t the device pointer into a convenient A register 

move. 1 a5, - (sp) 
move .1 dO , a5 

; save a pointer to exec 

move .1 a6 , md_SysLib (a5) 

; save a pointer to our loaded code 

move.l aO,md_SegList(a5) 

. open the dos library 

lea dosName (pc) , al 

CLEAR dO 

CALLSYS OpenLibrary 

move .1 dO , md_DosLib (a5) 
bne . s initJDosOK 



ALERT 
init_DosOK: 



can't open the dos! what gives 
AG_OpenLib ! AO_DOSLib 



now build the static data that we need 



put your initialization here. 



move . 1 
move . 1 
rts 



a5,d0 
(sp)+,a5 



here begins the system interface commands. When the user calls 
OpenLibrary/CloseLibrary/RemoveLibrary, this eventually gets translated 
into a call to the following routines (Open/Close/Expunge) . Exec 
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has already put our device pointer in a6 for us. Exec has turned 
off task switching while in these routines (via Forbid/Permit) , so 
we should not take too long in them. 



; Open sets the IO_ERROR field on an error. If it was success full, 
; we should set up the IO_UNIT field. 

Open: ; ( devlce:a6, iob:al, unitnum:dO, flags:dl ) 

movem.l d2/a2/a3/a4, - (sp) 

move.l al,a2 ; save the lob 

; see if the unit number is in range 

moveq #MD_NUMUNITS,d2 

cmp.l d2,d0 

bcc.s OpenJError ; unit number out of range 

; see if the unit Is already initialized 

move.l d0,d2 ; save unit number 

lsl.l #2,d0 

lea.l md_Units(a6 / d0.1) > a4 

move.l (a4),d0 

bne . s QpenJUni tOK 

; try and conjure up a unit 

bsr InitUhit 

. see if it initialized OK 

move . 1 (a4) , dO 
beq . s Open_Error 

Open_UnitOK: 

move.l d0,a3 ; unit pointer in a3 

move .1 dO , I0_UNIT (a2) 

; mark us as having another opener 

addq . w #1 , LI B_0PENCNT (a6) 
addq . w #1 , UNIT_OPENCNT (a3) 

; prevent delayed expunges 

bclr #LIBB_PELEXP,mcLFlags(a6) 

Open_End : 

movem . 1 (sp) + , d2/a2/a3/a4 

rts 

Open_Error : 

move.b #I0ERR w 0PENFAIL,I0_ERR0R(a2) 
bra.s Qpen_End 

; There are two different things that might be returned from 
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; the Close routine. If the device Is no longer open and 

; there is a delayed expunge then Close should return the 

; segment list (as given to Inlt) . Otherwise close should 

; return NULL. 

Close: ; ( device :a6, iob:al ) 
movem. 1 a2/a3, - (sp) 

move .1 al , a2 

move . 1 IO_UNIT (a2) , a3 

; make sure the iob is not used again 

moveq.l #-l,dO 

move .1 dO , IO_UNIT (a2) 

move .1 dO , ICLDEVICE (a2) 

; see if the unit is still in use 

subq.w #l,UNIT_0PENCNT(a3) 
bne . s Close_Device 

bsr ExpungeUnit 

Close_Device : 

; mark us as having one fewer openers 

subq.w #l,LIB_0PENCNT(a6) 

. see if there is anyone left with us open 

bne . s Close_End 

; see if we have a delayed expunge pending 

btst #LIBB_JDELEXP,md_Flags(a6) 
beq.s Close_End 

. <ji thg expunge 

bsr Expunge 

Close_End: 

movem . 1 (sp) + , a2/a3 
rts 



There are two different things that might be returned from 
the Expunge routine. If the device is no longer open 
then Expunge should return the segment list (as given to 
Init) . Otherwise Expunge should set the delayed expunge 
flag and return NULL. 

One other important note: because Expunge is called from 
the memory allocator, it may NEVER Wait() or otherwise 
take long time to complete. 

Expunge: ; ( device: a6 ) 

movem. 1 d2/a5/a6, - (sp) 
move .1 a6 , a5 
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move . 1 md_SysLib (a5) , a6 

; see If anyone has us open 

tst . w LIB_OPENCNT (a5) 
beq 1$ 

; it Is still open, set the delayed expunge flag 

bset #LIBBJDELEXP,md_Jlags(a5) 

CLEAR dO 

bra . s Expunge JEnd 

1$: 

; go ahead and get rid of us. Store our seglist in d2 

move . 1 md_SegList (a5) , d2 

; unlink from device list 

move.l a5,a0 
CALLSYS Remove 

* 

; device specific closings here. . . 

* 

. close the dos library 

move . 1 mdJDosLib (a5) , al 
CALLSYS CloseLibrary 

; free our memory 

move.l a5,al 

move . 1 LIB_NEGSIZE (a5) , dO 

sub.l dO.al 

add. 1 LIBJPOSSIZE (a5) . dO 

CALLSYS FreeMem 

. set ^ our re turn value 

move.l d2,d0 

Expunge_End : 

movem . 1 (sp) + , d2/a5/a6 
rts 



Null: 

CLEAR dO 
rts 



InitUnit: ; ( d2:unit number. a3: scratch, a6:devptr ) 
movem. 1 d2/d3/d4, - (sp) 



; allocate unit memory 

move.l #MyDevUnlt_Sizeof,dO 

move . 1 #MEMF_PUBLIC ! MEMF_CLEAR, dl 

LINKSYS AllocMem,md_SysLib(a6) 
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tst.l 
beq 

oove.l 
move.b 



dO 

InltUnitJEnd 

d0,a3 

d2 . mdtuuhitNum (a3) 



Initialize unit: number 



start up the unit process. We do a trick here — 
we set his message port to PA^IGNORE until the 
new process has a change to set it up. 
We cannot go to sleep here: it would be very nasty 
if someone else tried to open the unit 
(exec's OpenDevice has done a Forbid () for us -- 
we depend on this to become single threaded) . 
#MYPR0CSTACKSIZE,d4 ; stack size 
#myproc_seglist,d3 ; segment list 
#2,d3 ; change to bcpl pointer 

#MYPR0CPRI,d2 ; pick out its priority 

#myName,dl ; name is the device's 



move.l 

move.l 

lsr.l 

moveq 

move . 1 

LINKSYS CreateProc , mdJDosLib (a6) 



tst.l 
beq 



move.l 
move . 1 
lea 

move . 1 
move.b 



dO 
InitUnit_FreeUhit 

set up the unit structures for the new process 

dO , mdu_Process (a3) 

dO,aO 

-pr_MsgPort (aO) , aO 

aO,MP_SIGTASK(a3) 

#PA_IGNORE , MP_FLAGS (a3) 



; send a startup message to the new process 

lea mdtcMsg (a3) , al 
move . 1 a3,mdm_Uhit (al) 
move .1 a6 , mdm_Pevice (al) 
move.l dO,aO 
LINKSYS PutMsg,md_SysLib(a6) 



message port is new process port 



; mark us as ready to go 

move.l d2 / d0 
lsl.l #2,d0 
move.l a3,md_Units(a6,d0.1) 



unit number 
set unit table 



InitUnit_End: 

movem . 1 (sp) + , d2/d3/d4 

rts 

. g 0t an error. 

InitUnitJ'reeOnit : 

bsr FreeUnit 
bra . s InitUnit_End 



free the unit structure that we allocated. 



FreeUnit: ; ( a3:unitptr / a6:deviceptr ) 
move.l a3,al 
move . 1 ttMyDevUnit_Sizeof , dO 
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LINKSYS FreeMem,ind_SysLib(a6) 
rts 



ExpungeUnit: ; ( a3:unitptr, a6 : deviceptr ) 
move.l d2,-(sp) 



get rid of the unit's task. We know this is safe 

because the unit has an open count of zero, so it 

is 'guaranteed' not in use. 

move . 1 mdu_Process (a3) , al 

lea - (pr_MsgPort) (al) , al 

LINKSYS RemTask,md_SysLib(a6) 

; save the unit number 

CLEAR d2 

move . b mdu_UnltNum (a3) , d2 



bsr 



free the unit structure. 
FreeUnit 



lsl.l 
clr.l 

move . 1 

rts 



clear out the unit vector in the device 

#2,d2 

md_Units(a6,d2.1) 

(sp)+,d2 



here begins the device specific functions 



; cmdtable is 


used to look 


up the address of 


; implement the device command. 




cmdtable : 








DC.L 


Invalid 




• $00000001 


DC.L 


MyReset 




• $00000002 


DC.L 


Read 




• $00000004 


DC.L 


Write 




• $00000008 


DC.L 


Update 




$00000010 


DC.L 


Clear 




$00000020 


DC.L 


MyStop 




$00000040 


DC.L 


Start 




$00000080 


DC.L 


Flush 




$00000100 


DC.L 


Foo 




$00000200 


DC.L 


Bar 




$00000400 


cmdtable_end : 









a routine that will 



; this define is used to tell which commands should not be queued 
; command zero is bit zero. 

; The immediate commands are Invalid, Reset, Stop, Start, Flush 
IMMEDIATES EQU $000001c3 
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BeglnIO starts all Incoming lo. The 10 Is either queued up for the 
unit task or processed Immediately. 

BeglnIO: ; ( lob: al, device :a6 ) 
move.l a3,-(sp) 

; bookkeeping 

move . 1 I0_UNIT (al) , a3 

; see If the io command Is within range 

move . w I0_CC**4AND (al) , dO 
cmp.w #MXDEV_END,dO 
bcc.s BeginIO_NoCmd 

DISABLE aO 

. process all Immediate commands no matter what 

move . w #IM4EDI ATES , dl 

btst d0,dl 

bne . s Beglnl 0_lmmediate 

; see if the unit is STOPPED. If so, queue the msg. 

btst #MDUB_STOPPED,.UNIT_eLAGS (a3) 
bne.s BeginIO_QueueMsg 

. this is not an immediate command, see if the device is 

; busy. 

bset #UNITB.JVCTIVE . UNIT_FLAG5 (a3) 
beq.s BeginIO_Immediate 

. we neec i to queue the device . mark us as needing 

; task attention. Clear the quick flag 

BeginIO_QueueMsg : 

BSET #UNITB_INTASK,UNIT_FLAGS(a3) 
bclr #I0B_QUICK, IO_FLAGS (al) 

ENABLE aO 

move.l a3,a0 

LINKSYS PutMsg,md_SysLib(a6) 

bra.s BeglnI0_End 

BeginlO.Immediate : 
ENABLE aO 

bsr Per f oral 

BeginIO_End: 

move.l (sp)+,a3 
rts 

BeginIO_NoCmd : 

move . b #1 OERRJTOCMD , i o_ERROR (al) 
bra.s BeginIO_End 
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PerformlO actually dispatches an io request. It expects a3 to already 
have the unit pointer in it. a6 has the device pointer (as always) . 
al has the io request. Bounds checking has already been done on 
the io request. 



PerformlO: ; ( iob:al, unitptr:a3, devptr:a6 ) 

move.l a2,~(sp) 

move.l al,a2 

move . w IO_COMMAND (a2) , dO 

lea cmdtable (pc) , aO 

move. 1 (aO, dO .w) , aO 



jsr 



(aO) 



move.l (sp)+,a2 
rts 



TermlO sends the IO request back to the user. It knows not to mark 
the device as inactive if this was an immediate request or if the 
request was started from the server task. 



TermlO: ; ( iob:al, unitptr:a3, devptr:a6 ) 

move . w I0_O*MAND (al) , dO 

move . w #IMMEDI ATES , dl 

btst dO,dl 

bne . s TermI 0_lmmediate 

; we may need to turn the active bit off. 

btst #UNITB_INTASK, UNITJETAGS (a3) 
bne . s TermIO_Immediate 

; the task does not have more work to do 

bclr #UNITB_ACTIVE,UNITjeLAGS(a3) 

TermI 0_lmmediate : 

; if the quick bit is still set then we don't need to reply 

; msg -- just return to the user. 

btst #IOB_QUICK, IO_FLAGS (al) 
bne . s TermI OL End 

LINKSYS ReplyMsg / md_SysLib(a6) 

TermI 0_End: 
rts 



AbortIO: 



( iob: al, device :a6 ) 
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here begins the functions that Implement the device commands 
all functions are called with: 

al — a pointer to the lo request block 

a2 — another pointer to the lob 

a3 -- a pointer to the unit 

a6 — a pointer to the device 

Commands that conflict with 68000 instructions have a "My" prepended 
to them. 



Invalid: 



move.b 
bsr 

rts 



#I0ERR_N0CMD, IOJSRRGR (al) 
TermlO 



MyReset : 



! ! fill me in ! 

! fill me in ! 

! fill me in ! 

! fill me in ! 



the Read command acts as an infinite source of nulls. It clears 
the user's buffer and marks that many bytes as having been read. 



Read: 



move . 1 I0_PATA (al) , aO 
move . 1 I0_LENGTH (al) , dO 
move .1 dO , IO^ACTUAL (al) 



beq.s 



deal with a zero length read 
ReadJEnd 



CLEAR 



now copy the data 
dl 



ReacLLoop : 

move.b dl, (a0)+ 

subq.l #l,d0 

bne . s Read_Loop 



Read_End: 



bsr 

rts 



TermlO 



the Write command acts as bit bucket. It clears acknowledges all 
the bytes the user has tried to write to it. 
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Write: 

move . 1 lO^LENGTH (al) , IO^ACTUAL (al) 

bsr TermlO 
rts 



Update and Clear are internal buffering commands. Update forces all 
io out to its final resting spot, and does not return until this is 
done. Clear invalidates all internal buffers. Since this device 
has no internal buffers, these commands do not apply. 



Update: 
Clear : 



bra 



Invalid 



the Stop command stop all future io requests from being 
processed until a Start command is received. The Stop 
command is NOT stackable: e.g. no matter how many stops 
have been issued, it only takes one Start to restart 
processing. 



MyStop: 



bset 

bsr 
rts 



Start : 



bsr 

move . 1 
bsr 

rts 

InternalStart : 

bclr 



#MDUB_STOPPED, UNIT JLAGS (a3) 
TermlO 

InternalStart 

a2,al 

TermlO 



turn processing back on 
#MDUB_STOPPED, UNIT_JLAGS (a3) 



. kick the task to start it moving 

move.l a3,al 

CLEAR dO 

move . 1 MP_SIGBIT (a3) , dl 

bset dl,dO 

LINKSYS Signal, md_SysLib(a3) 

rts 



Flush pulls all io requests off the queue and sends them back. 
We must be careful not to destroy work in progress, and also 
that we do not let some io requests slip by. 
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Some funny magic goes on with the STOPPED bit in here. Stop is 
defined as not being reentrant. We therefore save the old state 
of the bit and then restore it later. This keeps us from 
needing to DISABLE in flush. It also fails miserably if someone 
does a start in the middle of a flush. 



Flush: 



movem.l 


d2/a6, - (sp) 


move.l 


md_SysLib (a6) , a6 


bset 
sne 


#MDUB_STOPPED, UNIT_FLAGS (a3) 
d2 


Flush_Loop : 

move . 1 
CALLSYS 


a3,a0 
GetMsg 


tst.l 
beq.s 


dO 

Flush_End 


move.l dO,al 

move .b #IOERR_ABORTED, IOJBRCR (al) 

CALLSYS ReplyMsg 


bra.s 


Flush-Loop 


Flush_End: 




move . 1 
movem.] 


d2,d0 
(sp)+,d2/a6 


tst.b 
beq.s 


dO 

1$ 



1$: 



bsr 



InternalStart 



move . 1 
bsr 



a2,al 

TermlO 



rts 



Foo and Bar are two device specific commands that are provided just 
to show you how to add your own commands. The currently return that 
no work was done. 



Foo: 
Bar: 



CLEAR dO 

move.l dO,IO-ACTUAL(al) 



***_ 
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bsr TermlO 
rts 



here begins the process related routines 

A Process Is provided so that queued requests may be processed at 

a later time. 



Register Usage 

a3 — unit pointer 

a6 -- syslib pointer 

a5 — device pointer 

a4 -- task (ITOT process) pointer 

d7 — wait mask 



. some dos magic. A process is started at the first executable address 

£?Kn2 * eg r? t , list l W® hand c ™^ * segment list here. See toe 
, the DOS technical reference if you really need to know more about this. 

£3°? ?- 4 ; long word alllgn 

myproc_segilst: *' ma ^ Bt length " "V nuniber wil1 d «> 

°C.L ; pointer to next segment 

; the next Instruction after the segment list is the first executable address 
Proc_Begin: 

move.l _AbsExecBase, a6 

; wait for our first packet 

r^r'^vo ^'^i , ; <m y task> = FindTask(O) 

CALLSYS FindTask x ' 

move.l dO,aO 

move.l d0,a4 ; save task in a4 

J^LSYS SsSSfT* (30) ' a ° '* ^ "* P ° rt ' ° r "* P rocesses 

; taikB msg off the port 

move.l dO,al 

^ff^ -°' a2 ' - save «h« message 

CALLSYS Remove 

; get our parameters out of it 

move.l mdm_Device(a2),a5 ; a 5 is now our device 

move.l mdm_Unlt (a2) . a3 

; Allocate the right signal 

™?S»« tf,~^' d l ; _1 is ^V signal at all 

CALLSYS AllocSignal 
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move . b dO , MP_SIGBIT (a3) 
move.b #PA_SIGNAL,MP_FLAGS(a3) 



CLEAR 
bset 



change the bit number into a mask, and save in d7 

d7 

d0,d7 



bra.s 



OK, kids, we are done with initialization. We now 
can start the main loop of the driver. It goes 
like this. Because we had the port marked PA_IGNORE 
for a while (in InitUnit) we jump to the getmsg 
code on entry. 

wait for a message 

lock the device 

get a message, if no message unlock device and loop 

dispatch the message 

loop back to get a message 



Proc_CheckStatus 

main loop: wait for a new message 



Proc_HainLoop : 

move.l d7,d0 
CALLSYS Wait 

Proc_CheckStatus : 

see if we are stopped 
#MDUB_STOPPED / UNIT_FLAGS (a3) 



btst 
bne.s 



Proc_MainLoop 



device is stopped 



bset 
bne.s 



lock the device 
#UNITB_ACTIVE, UNIT.JXAGS (a3) 



ProcJlainLoop 



device in use 



; get the next request 

Proc_NextMessage : 

move.l a3,a0 
CALLSYS GetMsg 
tst . 1 dO 
beq . s Pr oc_lflnl ock 

; do this request 

move.l dO,al 

exg a5,a6 

bsr PerformlO 

exg a5,a6 



no message? 

put device ptr in right place 
get syslib back in a6 



bra.s 



Proc_Unlock: 



Proc_NextMessage 
no more messages. 



back ourselves out. 
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and.b #$ff&(UNITB w ACTIVE!UNITB_INTASK) , UNITJFLAGS (a3) 
bra Proc_J4ainLoop 



ProcJail : 



bsr 

rts 



we come here on Initialization failures 
FreeUnit 



EndCode Is a marker that show the end of your code. 
Make sure It does not span sections nor Is before the 
rom tag in memory! It is ok to put It right after 
the rom tag -- that way you are always safe. I put 
it here because it happens to be the "right" thing 
to do, and I know that it is safe in this case. 

EndCode: 



END 



Appendix L 
Disk Format Information 



This appendix contains information useful to the developer who desires to take over the 
entire machine. That is, rather than use AmigaDOS to load the code, the application is to 
boot directly after Kickstart, not using AmigaDOS or Intuition. This appendix provides two 
pieces of information: the disk boot block format, and the format of the actual data on disk. 
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THE BOOT PROCESS 

The first two sectors are read into the system at an arbitrary position; 
therefore, the code MUST be PC-relative. The first three longwords are' as 
in devices/bootblock.h. The type should be BBID_DOS; the checksum must 
be correct (as in additive carry wraparound sum of Oxffffffff) . 
Execution starts at location 12 of the sectors that were read in. 

The code is called with an open disk I/O request in Al (see the TrackDisk 
chapter for the format of this IOReguest block) . The boot 
code is free to use it as it wishes (it may trash Al, but must 
not trash the io block itself) . 

The boot code returns two values: DO and AO. DO is a failure code -- 
if it is non-zero then a system alert will be called, then the boot code 
falls into the debugger. 

If DO is null then AO contains the start address to jump to. The strap 
module will free the boot sectors, close the I/O block, do any other 
cleanup that is required, and jump to the location pointed to by AO. 



COMMODORE-AMIGA DISK FORMAT 

The following are details about how the bits on the Commodore -Amiga disk 
are actually written. 

Gross Data Organization: 

3 1/2 inch disk 

double-sided 

80 cylinders/160 tracks 

Per -track Organization: 

Nulls written as a gap, then 11 sectors of data. 
No gaps written between sectors. 

Per-sector Organization: 

All data is MFM encoded. This is the pre-encoded contents 
of each sector: 

two bytes of 00 data (MFM = AAAA each) 

two bytes of Al* ( "standard sync byte" -- MFM 

encoded Al without a clock pulse ) 
(MFM = 4489 each) 

one byte of format-byte 

(Amiga 1.0 format = FF) 

one byte of track number 

one byte of sector number 

one byte of sectors until end of write (NOTE 1) 
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[above 4 bytes treated as one longword 
for purposes of MFM encoding] 



16 



NOTES: 



NOTE 1. 



bytes of OS recovery Info (NOTE 2) 

[treated as a block of 16 bytes for encoding] 
four bytes of header checksum 

[treated as a longword for encoding] 
four bytes of data- area checksum 

[treated as a longword for encoding] 
512 bytes of data 

[treated as a block of 512 bytes for encoding] 



The track number and sector number are constant for each 
particular sector. However, the sector offset byte changes 
each time we rewrite the track. 

The Amiga does a full track read starting at a random 
position on the track and going for slightly more 
than a full track read to assure that all data gets into the 
buffer. The data buffer is examined to determine where the 
first sector of data begins as compared to the start of the 
buffer. The track data is block moved to the beginning of 
the buffer so as to align some sector with the first location 
in the buffer. 

Because we start reading at a random spot, the read data may 

be divided into three chunks: a series of sectors, the track 

gap, and another series of sectors. The sector offset 

value tells the disk software how many more 

sectors remain before the gap. From this the software can 

figure out the buffer memory location of the last byte 

of legal data in the buffer. It can then search past the gap 

for the next sync byte and, having found it, can block move 

the rest of the disk data so that all 11 sectors of data are 

contiguous . 

Example: 

first-ever write of the track from a buffer like this: 

<GAP> | sectorO | sectorl | sector2 | | sectorlO | 

sector offset values: 



11 



10 



(if I find this one at the start of my read buffer, 
then I know there are this many more sectors 
with no intervening gaps before I hit a gap) . 
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sample read of this track: 

< jurik> | sector9 | sectorlO | <gap> | sectorO | . . . | sector8 | < junk> 

value of 'sectors till end of write' : 

2 1 11 3 

result of track realligning: 

<GAP> | sector9 | sectorlO | sectorO | . . . | sector8 | 

new sectors till end of write: 

11 10 9 ... 1 

so that when the track is rewritten, the sector offsets 
are adjusted to match the way the data was written. 



NOTE 2. This is operating systems dependent data and relates 
to how AmigaDos assigns sectors to files. 



Reserved for future use. 



GENERAL: 



When data is MFM encoded, the encoding is performed on 
the basis of a data block-size. In the sector encoding 
described above, there are bytes individually encoded; 
three segments of 4 bytes of data each, treated as 
longwords; one segment of 16 bytes treated as a block; two 
segments of longwords for the header and data checksums; 
and the data area of 512 bytes treated as a block. 

When the data is encoded, the odd bits are encoded first, 
then the even bits of the block. 

(Make a block of bytes formed from all odd bits of the block, 
encode as MFM. 

Make a block of bytes formed from all even bits of the block, 
encode as MFM. Even bits are shifted left one bit position 
before being encoded.) 
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SOURCE CODE FOR DATA ENCODE/DECODE 

decodeBlock( mfmbuffer, userbuffer, numwords ) 

WORD *mfmbuffer; /* the encoded data */ 

WORD *userbuffer; /* where to put the decoded data */ 

int numwords; /* the number of WORDS of data (not bytes) */ 

WORD * oddptr, *evenptr, oddbits, evenbits; 

oddptr = mfmbuffer; 

/* the even region starts right after the odd one */ 
evenptr = Amfmbuf fer [numwords] ; 

while ( numwords — > ) { 

/* mask off the mfm clock bits, and shift the word */ 
oddbits = ( (*oddptr++ « 1) & OxAAAA) ; 

/* even bits are already in the right place. Just mask off clock */ 
evenbits = ( (*evenptr++) & 0x5555) ; 



} 



/* recombine the two sections */ 
*userbuffer++ = oddbits | evenbits; 



encodeBlock( mfmbuffer, userbuffer, numwords ) 

WORD *mfmbuffer; /* where to put the encoded data */ 

WORD *userbuffer; /* the user data, before encoding */ 

int numwords; /* the number of WORDS of data (not bytes) */ 



< 



WORD * oddptr, * evenptr; 
WORD *ubuf; 



oddptr = mfmbuffer; 

/* the even region starts right after the odd one */ 
evenptr = Amfmbuf fer [numwords] ; 

/* mfmencode takes one word of mfm data can correctly sets 
* the clock bits 

V 

/* encode the odd bits */ 

for( ubuf = userbuffer, i = numwords; i>0;i--) •( 
oddptr++ = mfmencode ( (*ubuf++ » 1) & 0x5555 ) ; 

} 

/* encode the even bits */ 

for( ubuf = userbuffer, i = numwords; i>0;i — ) ■( 
evenptr++ = mfmencode ( *ubuf ++ & 0x5555 ) ; 

} 
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